Get Campaign Leads

Retrieves leads from a specific campaign, optionally filtered by state.

GET /campaigns/{campaignId}/leads

Get Campaign Leads

cURL

curl --request GET \
  --url https://api.lemlist.com/api/campaigns/{campaignId}/leads/ \
  --header 'Authorization: Basic <encoded-value>'

200

[
  {
    "_id": "lea_A1B2C3D4E5F6G7H8I9",
    "contactId": "con_Z9Y8X7W6V5U4T3S2R1",
    "state": "scanned"
  }
]

Leads are sorted by creation date (newest first). Use the state query parameter to filter leads by their current state (e.g., scanned, contacted, interested).

Authorizations

Authorization · string · header · required

Basic authentication header of the form Basic <encoded-value>, where <encoded-value> is the base64-encoded string username:password.

Path Parameters

campaignId · string · required

The unique identifier of the campaign

Query Parameters

state · string

Filter leads by state (e.g., scanned, contacted, interested, notInterested, etc.)

limit · integer · default: 100

Maximum number of leads to return. Default: 100, Max: 500

Required range: 1 <= x <= 500

Response

200 - application/json

List of leads in the campaign

_id · string

Unique lead identifier

contactId · string

Associated contact identifier

state · string

Current lead state