/v2/campaigns/:id/leadsLists the leads already in a campaign — the read counterpart to Add leads. Supports pagination and search.
| Authorization | Bearer YOUR_API_KEY |
| Field | Type | Required | Description |
|---|---|---|---|
| id | string | Required | Campaign ID. |
| limit | number | Optional | Page size, max 200, default 50. |
| cursor | string | Optional | Opaque pagination cursor from the previous response's nextCursor. |
| search | string | Optional | Free-text search across lead fields. |
| status | string | Optional | Filter by send status. |
curl "https://api.stynar.com/v2/campaigns/cmp_abc123/leads?limit=50" \
-H "Authorization: Bearer esk_your_key_here"{
"leads": [
{
"leadId": "lead_1a2b3c",
"status": "SENT",
"fields": {
"email": "jane@acme.com",
"firstName": "Jane"
}
}
],
"nextCursor": "eyJsZWFkSWQiOiJsZWFkXzFhMmIzYyJ9"
}| Status | Code | Meaning |
|---|---|---|
| ✕ 401 Unauthorized | UNAUTHORIZED | Missing, malformed, unknown, revoked, or expired key. |
| ✕ 403 Forbidden | API_ACCESS_DISABLED | API access is turned off for your account. |
| ✕ 403 Forbidden | INSUFFICIENT_SCOPE | The key doesn't have the scope this endpoint requires. |
| ✕ 404 Not Found | NOT_FOUND | Unknown route, or a resource that doesn't exist / isn't yours. |
| ✕ 409 Conflict | CONFLICT | The action can't be applied to the resource's current state. |
| ✕ 429 Too Many Requests | RATE_LIMIT_EXCEEDED | Per-minute or per-second limit hit. |
| ✕ 429 Too Many Requests | QUOTA_EXCEEDED | Monthly quota exhausted. |
| ✕ 500 Internal Server Error | INTERNAL_ERROR | Something broke on Stynar's end. |