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

# Get a stream run

> Check the status + progress log of a single sync run

Returns a single sync run's status, counts, and progress log. Used for polling progress + final-status reads.

The run must belong to the stream (its `(account, segment)` tuple appears in the stream's pairs).

## Response

```json theme={null}
{
  "run": {
    "id": 123,
    "streamId": 42,
    "streamName": "AI founders watching Yongfook",
    "trackedXAccountId": 7,
    "xHandle": "yongfook",
    "segmentId": 12,
    "segmentName": "AI founders building developer tools",
    "source": "manual",
    "status": "running",
    "mode": "sync-then-search",
    "triggeredAt": "2026-06-02T09:00:00Z",
    "completedAt": null,
    "newFollowersCount": 0,
    "candidatesPassedCount": 0,
    "mediumFitCount": 0,
    "enrichedCount": 0,
    "errorMessage": null,
    "progressLog": [
      { "step": "fetch_followers", "message": "Fetched 50 new followers", "timestamp": "..." }
    ]
  }
}
```

## Status values

| Value       | Meaning                                 |
| ----------- | --------------------------------------- |
| `queued`    | Waiting for Inngest worker              |
| `running`   | Pipeline in progress                    |
| `succeeded` | Completed cleanly                       |
| `failed`    | Aborted with error - see `errorMessage` |

## Auth

Bearer or session cookie.