> ## Documentation Index
> Fetch the complete documentation index at: https://docs.catchthegoodones.com/llms.txt
> Use this file to discover all available pages before exploring further.

# List sync runs (flat)

> Cross-stream flat list of recent sync runs

Returns a flat list of the user's recent sync runs across every campaign. Each row carries the parent stream's id + name (when the run's `(account, segment)` pair belongs to a stream). For per-stream history use [GET /api/v2/streams/{id}/runs](/api-reference/stream-runs).

## Query parameters

| Name    | Type   | Description         |
| ------- | ------ | ------------------- |
| `limit` | number | Default 30, max 100 |

## Response

```json theme={null}
{
  "runs": [
    {
      "id": 123,
      "streamId": 42,
      "streamName": "AI founders watching Yongfook",
      "streamIsActive": true,
      "trackedXAccountId": 7,
      "xHandle": "yongfook",
      "segmentId": 12,
      "segmentName": "AI founders building developer tools",
      "source": "cron",
      "status": "succeeded",
      "triggeredAt": "2026-06-02T09:00:00Z",
      "completedAt": "2026-06-02T09:01:23Z",
      "newFollowersCount": 50,
      "candidatesPassedCount": 12,
      "mediumFitCount": 4,
      "enrichedCount": 8,
      "errorMessage": null,
      "progressLog": []
    }
  ]
}
```

`streamId` / `streamName` / `streamIsActive` are null for sync runs whose `(account, segment)` pair no longer belongs to any stream (orphaned manual runs).

## Auth

Bearer or session cookie.