GET /leads/campaign/{campaignId}

Authentication

Send your organization API key as a Bearer credential.

Authorization: Bearer YOUR_API_KEY

Path parameters

campaignId string required

Campaign UUID

Example: 550e8400-e29b-41d4-a716-446655440000

Query parameters

after_id number

Seek-pagination cursor. Returns leads with an ID greater than this value.

Range: x ≥ 1

Example: 100
offset number

Pagination offset. Must be 0 or greater.

Range: x ≥ 0

Example: 0
limit number

Pagination limit. Must be between 1 and 200.

Range: x ≥ 1, x ≤ 200

Example: 50
search string

Case-insensitive email search string.

Example: john

Response

application/json

Leads retrieved successfully

total number required

Total leads matching the query

Example: 125
offset number required

Pagination offset

Example: 0
limit number required

Pagination limit

Example: 50
items object[] required

Leads page

Show child attributes Hide child attributes
items.id number required

ID of the lead

Example: 1
items.email string required

Email address of the lead

Example: john.doe@example.com
items.first_name string required

First name of the lead

Example: John
items.last_name string required

Last name of the lead

Example: Doe
items.company string required

Company of the lead

Example: OpenAI
items.website string required

Website of the lead

Example: https://openai.com
items.personalization string required

Personalization text

Example: Hi John, I saw you work at OpenAI…
items.sender string required

The email account from which the email was sent

Example: outbound@coldy.ai
items.verification_status string required

Verification status of the email

Allowed values: valid, unknown, accept_all, invalid, disposable, not_verified

Example: valid
items.status string required

Current status of the lead

Allowed values: Not contacted, Sent, Bounce, Replied, Opened

Example: Not contacted
items.campaign_id string required

ID of the associated campaign

Example: 550e8400-e29b-41d4-a716-446655440000
items.id_previous_sending_sequence number required

ID of previous sending sequence

Example: 0
items.amount_sequences_sent number required

Number of sequences already sent

Example: 2
items.date_last_sequence_send string required

Date of the last sequence sent

Example: 2025-10-01T12:34:56.000Z
items.reply_text string required

Reply text if lead responded

Example: Sure, let’s talk next week.
items.reply_status string required

Reply status

Example: positive
items.reply_status_tag_id number required

ID of the attached reply tag

Example: 12
items.stop_sending boolean required

Whether sending is stopped for this lead

Example: false
items.stop_sending_type string required

Type of stop sending rule applied

Example: manual
items.chosen_sender number required

Chosen sender account ID

Example: 101
items.provider string required

Provider used for sending

Example: gmail