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

> List all your lead-streaming campaigns

Lists the campaigns (streams) owned by the authenticated user. Each row carries the campaign settings + the list of `(account, segment)` pairs.

## Query parameters

| Name              | Type    | Description                                |
| ----------------- | ------- | ------------------------------------------ |
| `includeInactive` | boolean | Include paused streams. Default `false`.   |
| `includeArchived` | boolean | Include archived streams. Default `false`. |

## Response

```json theme={null}
{
  "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](/api-reference/authentication).

## Example

```bash theme={null}
curl https://www.catchthegoodones.com/api/v2/streams \
  -H "Authorization: Bearer ctgo_..."
```