Skip to main content
GET
/
api
/
v2
/
streams
List streams
curl --request GET \
  --url https://api.example.com/api/v2/streams
Lists the campaigns (streams) owned by the authenticated user. Each row carries the campaign settings + the list of (account, segment) pairs.

​
Query parameters

NameTypeDescription
includeInactivebooleanInclude paused streams. Default false.
includeArchivedbooleanInclude archived streams. Default false.

​
Response

{
  "streams": [
    {
      "id": 42,
      "name": "AI founders watching Yongfook",
      "syncTimes": ["09:00"],
      "timezone": "Europe/London",
      "autoEnrichLinkedin": true,
      "autoEnrichEmail": true,
      "emailMode": "any",
      "deliveryDestination": "leads_only",
      "webhookUrl": null,
      "csvEmailRecipients": null,
      "isActive": true,
      "isArchived": false,
      "createdAt": "2026-06-02T10:00:00Z",
      "updatedAt": "2026-06-02T10:00:00Z",
      "pairs": [
        {
          "streamPairId": 101,
          "trackedAccountId": 7,
          "xHandle": "yongfook",
          "profileImageUrl": "...",
          "tier": "starter",
          "segmentId": 12,
          "segmentName": null,
          "segmentDescription": "AI founders building developer tools"
        }
      ]
    }
  ]
}

​
Auth

Bearer API key or session cookie. See Authentication.

​
Example

curl https://www.catchthegoodones.com/api/v2/streams \
  -H "Authorization: Bearer ctgo_..."