Skip to main content
GET
/
api
/
v2
/
runs
List sync runs (flat)
curl --request GET \
  --url https://api.example.com/api/v2/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//runs.

​
Query parameters

NameTypeDescription
limitnumberDefault 30, max 100

​
Response

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