v3
latestOpenAPI 3.1.02026-07-31121144224.9 KBExternal: Data Sync
Get Garmin Backfill Status Endpoint
Get Garmin backfill status for backfill data types.
The backfill is webhook-based and auto-triggered after OAuth connection. Returns status for each data type independently. Max 30 days of history.
Response Fields:
- overall_status: pending | in_progress | complete | cancelled | retry_in_progress | permanently_failed
- current_window: Current window index (0-based)
- total_windows: Total number of 30-day windows (12)
- windows: Per-window-per-type matrix with done/pending/timed_out/failed states
- summary: Per-type aggregated counts (done, timed_out, failed)
- in_progress: Whether backfill is currently running (true for in_progress or retry_in_progress)
- retry_phase: Whether the retry phase is currently active
- retry_type: Data type currently being retried (null if not retrying)
- retry_window: Window index being retried (null if not retrying)
- attempt_count: Number of GC-and-retry cycles completed
- max_attempts: Maximum GC-and-retry cycles before permanently failed (3)
- permanently_failed: Whether backfill has exhausted all retry attempts
Window Cell States:
- done: Data received via webhook or Garmin API error (treated as done)
- pending: Not yet processed
- timed_out: No webhook received within timeout (warning)
- failed: Permanently failed after retry attempt (error)
get/api/v1/providers/garmin/users/{user_id}/backfill/status
Path parameters
user_idstring uuid required
Headers
X-Open-Wearables-API-Keystring nullable
Response
Successful Response
object required