Skip to main content
GET
/
campaigns
/
{campaignId}
/
leads
Get Campaign Leads
curl --request GET \
  --url https://api.lemlist.com/api/campaigns/{campaignId}/leads/ \
  --header 'Authorization: Basic <encoded-value>'
[
  {
    "_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