List leads

Paginated lead list with filters and workspace-wide stats.

GEThttps://app.boltsequencer.com/api/leads

Authentication

Bearer owner API key required. Send:

Authorization: Bearer bs_live_…
X-Workspace-Id: <workspace-uuid> (workspace you own)

Description

Paginated lead list with filters and workspace-wide stats.

Query parameters

q, status, segment, tag (repeatable), campaign, variant (requires campaign), hasReplied, contactHealth, date filters, custom field filters, limit, offset.

Response

Paginated items plus workspace stats (not filter-scoped).

Errors

400 — validation or business rule failure ({ "error": string }, sometimes issues[])
401 — missing or invalid API key
403 — suspended account, wrong workspace, or insufficient role
404 — resource not found in workspace
429 — rate limit (code: "RATE_LIMIT_EXCEEDED", Retry-After header)
500 — unexpected server error

Example

curl -sS -X GET "https://app.boltsequencer.com/api/leads" \
  -H "Authorization: Bearer bs_live_YOUR_KEY" \
  -H "X-Workspace-Id: YOUR_WORKSPACE_UUID"