Skip to main content
GET
/
api
/
v2
/
streams
/
{streamId}
/
runs
/
{runId}
Get a stream run
curl --request GET \
  --url https://api.example.com/api/v2/streams/{streamId}/runs/{runId}
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

{
  "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

ValueMeaning
queuedWaiting for Inngest worker
runningPipeline in progress
succeededCompleted cleanly
failedAborted with error - see errorMessage

​
Auth

Bearer or session cookie.