GET/campaigns/:campaignId/leads
List leads. 0 credits. Rate class: global.
Request
GET /campaigns/search-xyz/leads?limit=50
X-API-Key: sk_live_...
| Query | Required | Notes |
|---|---|---|
limit | No | 1–100, default 50 |
cursor | No | Opaque pagination cursor |
tag | No | Filter — see allowlist below |
replied | No | true | false |
needsReply | No | true only (false → 400) |
Use at most one of tag, replied, needsReply.
Filter tag allowlist
Interested, Information request, Not interested, Wrong person, Meeting request, Meeting booked, Resolved, To be defined
Response
{
"leads": [
{
"id": "lead_abc",
"fullName": "Jane Doe",
"firstName": "Jane",
"lastName": "Doe",
"email": "jane@acme.com",
"companyName": "Acme Dental",
"website": "https://acme.com",
"jobTitle": null,
"location": "Austin, TX",
"tag": null,
"replied": false,
"needsReply": false,
"stage": "new"
}
],
"nextCursor": null
}
| Field | Type |
|---|---|
id | string |
fullName | string | null |
firstName | string | null |
lastName | string | null |
email | string | null |
companyName | string | null |
website | string | null |
jobTitle | string | null |
location | string | null |
tag | string | null |
replied | boolean |
needsReply | boolean |
stage | new | messaged | replied | tagged | excluded | failed | handed_off |
MCP
Tool: list_leads.