---
title: "List/export leads with their contact-level disposition, cursor-paginated."
method: GET
path: "/leads"
tags: ["leads"]
---

# List/export leads with their contact-level disposition, cursor-paginated.

`GET /leads`

## Request

- Base URL: `https://api.coldrig.dev`
- URL: `https://api.coldrig.dev/leads`
- Auth: HTTP bearer

Also the export surface — paginate to dump the full book of business as JSON; there is no separate CSV endpoint.

## Query parameters

- `campaign` string
- `interestStatus` 'none' | 'interested' | 'meeting_booked' | 'not_now' | 'not_interested' | 'bad_fit' | 'out_of_office' | 'wrong_person': out_of_office reschedules the follow-up past the return date instead of treating silence as disinterest; wrong_person drives a referral ask. do_not_contact is deliberately not a member — that intent routes to POST /leads/suppress instead.
- `suppressed` boolean
- `replied` boolean
- `cursor` string
- `limit` integer

## Response `200`

Lead list page.

- LeadListPage
  - `leads` object[], required
    - `leadId` string, required
    - `email` string, required
    - `firstName` string, required
    - `company` string, required
    - `campaignId` string, required
    - `campaignName` string, required
    - `globalStatus` string, required
    - `interestStatus` 'none' | 'interested' | 'meeting_booked' | 'not_now' | 'not_interested' | 'bad_fit' | 'out_of_office' | 'wrong_person', required: out_of_office reschedules the follow-up past the return date instead of treating silence as disinterest; wrong_person drives a referral ask. do_not_contact is deliberately not a member — that intent routes to POST /leads/suppress instead.
    - `notes` string, required
    - `tags` string[], required
    - `suppressed` boolean, required
    - `lastEventType` string, nullable, required
    - `lastEventTs` integer, nullable, required
    - `createdAt` integer, required
  - `nextCursor` string, nullable, required

## Other responses

- `400`: Request body failed schema validation.
- `401`: Missing, invalid, or inactive bearer token.

---

[API](https://skmtc.dev/coldrig/apis/agent-cold-email-api.md) · [All operations](https://skmtc.dev/coldrig/apis/agent-cold-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/coldrig/apis/agent-cold-email-api/revisions/242a462d82c4?raw)