Skip to main content
GET
Get all leads for a specific campaign
Legacy endpoint - deprecated. Unversioned endpoints are scheduled for removal on July 31, 2026. A public v1 replacement is not currently listed in the v1 reference. This endpoint remains available for existing integrations until then.
Returns the record for a single campaign lead: the contact phone_number, the metadata object that carries dynamic variables for the agent (such as customer_name or product), the lead’s current status in the campaign queue (pending, in_progress, completed, failed, removed), the timestamp it was enrolled, and, once a call has been placed, the call_log_id you can use to fetch the produced call log through Get Call Log.

When to use this

  • Per-lead troubleshooting: confirm the dynamic variables sent to the agent for a specific contact match what was expected.
  • Status polling: check whether a specific lead has been dialled yet without scanning the entire campaign.
  • CRM sync: pull the lead’s final status and call log reference to write back the outcome into the originating CRM.
For bulk reporting, use List Call Logs filtered by campaign_id instead.

Path parameters

Errors

  • 404 Not Found is returned when the lead does not exist or has been removed.
  • 403 Forbidden is returned when the API key cannot read campaign data on this workspace.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

id
string
required

ID of the campaign

Response

List of leads

id
string
required

Signed lead ID

Example:

"lead_abc123"