> ## 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 leads from a stream

> Extract leads scoped to one campaign

Returns leads from one campaign. Supports filtering by lifecycle, match confidence, account, segment, and date.

For cross-campaign extraction use [GET /api/v2/leads](/api-reference/list-leads).

## Query parameters

| Name              | Type     | Description                                                    |
| ----------------- | -------- | -------------------------------------------------------------- |
| `lifecycle`       | enum     | `"new"` (un-exported) or `"exported"`                          |
| `matchConfidence` | enum     | `"high"` or `"medium"`                                         |
| `accountId`       | number   | Scope to one source account                                    |
| `segmentId`       | number   | Scope to one segment                                           |
| `since`           | ISO 8601 | Leads discovered after this timestamp                          |
| `limit`           | number   | Default 100, max 500                                           |
| `offset`          | number   | Pagination                                                     |
| `summary`         | boolean  | Return only counts (replaces the legacy /lead-counts endpoint) |

## Response (default)

```json theme={null}
{
  "leads": [
    {
      "id": 1234,
      "streamId": 42,
      "trackedXAccountId": 7,
      "segmentId": 12,
      "matchConfidence": "high",
      "sourceType": "new_follower",
      "discoveredAt": "2026-06-02T09:01:00Z",
      "exportedAt": null,
      "profile": {
        "xUserId": "1234567890",
        "handle": "alice",
        "displayName": "Alice Smith",
        "profileImageUrl": "...",
        "followerCount": 8200,
        "bio": "..."
      }
    }
  ],
  "total": 47,
  "hasMore": false
}
```

## Response with `?summary=true`

```json theme={null}
{ "highFitCount": 33, "mediumFitCount": 14 }
```

## Auth

Bearer or session cookie.