v3

latestOpenAPI 3.1.02026-07-31121144224.9 KB
External: 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