---
title: "List Recent Sync Events"
method: GET
path: "/api/v1/users/{user_id}/sync/recent"
tags: ["External: Sync Status"]
---

# List Recent Sync Events

`GET /api/v1/users/{user_id}/sync/recent`

Return the most recent stored sync events (newest first).

Events are kept in Redis for 24 h. Use this to seed the UI before
opening the SSE stream, or to inspect history without subscribing.

## Path parameters

- `user_id` string, uuid, required

## Query parameters

- `limit` integer

## Headers

- `X-Open-Wearables-API-Key` string, nullable

## Response `200`

Successful Response

- SyncStatusEvent[]
  - `event_id` string, uuid — Unique ID for this event.
  - `run_id` string, required — Identifier shared by all events of the same sync run.
  - `user_id` string, uuid, required
  - `provider` string, required — Provider slug (e.g. 'garmin', 'apple', 'whoop').
  - `source` 'pull' | 'webhook' | 'sdk' | 'backfill' | 'xml_import' | 'linked_account', required — How the sync was initiated / what transport delivers data.
  - `stage` 'queued' | 'started' | 'fetching' | 'processing' | 'saving' | 'completed' | 'failed' | 'cancelled', required — Coarse-grained stage label for a sync run.
  - `status` 'in_progress' | 'success' | 'partial' | 'failed' | 'cancelled' | 'skipped', required — Overall outcome state for the run.
  - `message` string, nullable
  - `progress` number, nullable — Optional 0..1 progress.
  - `items_processed` integer, nullable
  - `items_total` integer, nullable
  - `error` string, nullable
  - `primary_user_id` string, uuid, nullable — For LINKED_ACCOUNT events: the OW user whose sync run produced this data.
  - `metadata` object
  - `started_at` string, date-time, nullable
  - `ended_at` string, date-time, nullable
  - `timestamp` string, date-time

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.net/openwearables/apis/open-wearables-api.md) · [All operations](https://skmtc.net/openwearables/apis/open-wearables-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/openwearables/open-wearables-api/versions/37c1c527cd8f/schema)