> ## 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 runs for a stream

> Sync run history scoped to one campaign

Returns the sync run history for one stream. Each row is filtered to runs whose `(account, segment)` tuple appears in the stream's pairs.

For cross-stream history use [GET /api/v2/runs](/api-reference/sync-history).

## 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",
      "trackedXAccountId": 7,
      "xHandle": "yongfook",
      "segmentId": 12,
      "segmentName": "AI founders building developer tools",
      "source": "cron",
      "status": "succeeded",
      "mode": "sync-then-search",
      "triggeredAt": "2026-06-02T09:00:00Z",
      "completedAt": "2026-06-02T09:01:23Z",
      "newFollowersCount": 50,
      "candidatesPassedCount": 12,
      "mediumFitCount": 4,
      "enrichedCount": 8,
      "errorMessage": null,
      "progressLog": []
    }
  ]
}
```

## Auth

Bearer or session cookie.