---
title: "List All Sync Run Summaries"
method: GET
path: "/api/v1/sync/runs"
tags: ["External: Sync Status"]
---

# List All Sync Run Summaries

`GET /api/v1/sync/runs`

Return aggregated per-run summaries across all users (admin view).

Supports optional filtering by user_id, provider, status, and source.

## Query parameters

- `limit` integer
- `user_id` string, uuid, nullable — Filter by user ID.
- `provider` string, nullable — Filter by provider name.
- `status` string, nullable — Filter by status.
- `source` string, nullable — Filter by source.

## Headers

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

## Response `200`

Successful Response

- SyncRunSummary[]
  - `run_id` string, required
  - `user_id` string, uuid, required
  - `provider` string, required
  - `source` string, required
  - `stage` string, required
  - `status` string, required
  - `message` string, nullable
  - `progress` number, nullable
  - `items_processed` integer, nullable
  - `items_total` integer, nullable
  - `error` string, nullable
  - `primary_user_id` string, uuid, nullable
  - `started_at` string, date-time, nullable
  - `ended_at` string, date-time, nullable
  - `last_update` string, date-time, required

## 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)