Export Campaign Leads

Exports leads from a campaign with flexible filtering and format options.

GET /campaigns/{campaignId}/export/leads

Export Campaign Leads

cURL

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

import requests

url = "https://api.lemlist.com/api/campaigns/{campaignId}/export/leads"

headers = {"Authorization": "Basic <encoded-value>"}

response = requests.get(url, headers=headers)

print(response.text)

const options = {method: 'GET', headers: {Authorization: 'Basic <encoded-value>'}};

fetch('https://api.lemlist.com/api/campaigns/{campaignId}/export/leads', options)
  .then(res => res.json())
  .then(res => console.log(res))
  .catch(err => console.error(err));

require 'uri'
require 'net/http'

url = URI("https://api.lemlist.com/api/campaigns/{campaignId}/export/leads")

http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true

request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Basic <encoded-value>'

response = http.request(request)
puts response.read_body

<?php

$curl = curl_init();

curl_setopt_array($curl, [
  CURLOPT_URL => "https://api.lemlist.com/api/campaigns/{campaignId}/export/leads",
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_ENCODING => "",
  CURLOPT_MAXREDIRS => 10,
  CURLOPT_TIMEOUT => 30,
  CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
  CURLOPT_CUSTOMREQUEST => "GET",
  CURLOPT_HTTPHEADER => [
    "Authorization: Basic <encoded-value>"
  ],
]);

$response = curl_exec($curl);
$err = curl_error($curl);

curl_close($curl);

if ($err) {
  echo "cURL Error #:" . $err;
} else {
  echo $response;
}

400

"Bad team"

"Campaign not found"

The export returns leads in CSV or JSON format based on their state.

Filtering by state

Use the state parameter to filter leads by their current status. You can:

• Export all leads: state=all
• Filter by specific states: state=emailsOpened,emailsReplied
• Use multiple states: state=interested,warmed

Global states

These group multiple lead states into a single category:

State	Description
imported	Leads imported without processing (not scanned, no steps sent, not reviewed)
scanned	Leads scanned by LinkedIn or email verification
skipped	Leads skipped during review
reviewed	Leads that were reviewed
contacted	Leads that were contacted (at least one step executed, no response yet)
hooked	Leads that opened an email or LinkedIn message
attracted	Leads that clicked in an email or accepted a LinkedIn invite
warmed	Leads that replied to an email or LinkedIn message
interested	Leads marked as interested
notInterested	Leads marked as not interested
emailsBounced	Leads where at least one step bounced or failed
emailsUnsubscribed	Leads that unsubscribed
meetingBooked	Leads that booked a meeting
paused	Leads that were paused

Detailed states

For more granular filtering:

State	Description
emailsSent	Email was sent
emailsOpened	Lead opened an email
emailsClicked	Lead clicked on an email
emailsReplied	Lead replied to an email
emailsInterested	Lead marked as success via email
emailsNotInterested	Lead marked as not a success via email
emailsFailed	Error sending email
linkedinVisitDone	LinkedIn profile was visited
linkedinInviteDone	LinkedIn invitation was sent
linkedinInviteAccepted	LinkedIn invitation was accepted
linkedinSent	LinkedIn message was sent
linkedinOpened	LinkedIn message was opened
linkedinReplied	Lead replied on LinkedIn
linkedinInterested	Lead marked as success via LinkedIn
linkedinNotInterested	Lead marked as not a success via LinkedIn

Output format

Use the format parameter to choose between:

• csv (default): Returns a CSV file suitable for Excel, Google Sheets, etc.
• json: Returns structured JSON data for programmatic processing

Examples

Export all leads as CSV

curl --request GET \
  --url 'https://api.lemlist.com/api/campaigns/cam_123/export/leads?state=all' \
 --header 'Authorization: Basic <encoded-value>'

curl --request GET \
  --url 'https://api.lemlist.com/api/campaigns/cam_123/export/leads?state=interested&format=json' \
 --header 'Authorization: Basic <encoded-value>'

curl --request GET \
  --url 'https://api.lemlist.com/api/campaigns/cam_123/export/leads?state=emailsOpened,emailsReplied,interested' \
  --header 'Authorization: Basic <encoded-value>'

Use global states like hooked or warmed to quickly segment leads by engagement level, or use detailed states for precise filtering based on specific actions.

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 · enum<string> · default: all

Filter to export only the specified lead's last states. Use 'all' to export all states. Can be a comma-separated list of states. Global states: imported, scanned, skipped, reviewed, contacted, hooked, attracted, warmed, interested, notInterested, emailsBounced, emailsUnsubscribed, failed, meetingBooked, paused. Detailed states: emailsSent, emailsOpened, emailsClicked, emailsReplied, emailsInterested, emailsNotInterested, emailsFailed, opportunitiesDone, aircallDone, aircallInterested, aircallNotInterested, apiDone, apiInterested, apiNotInterested, linkedinVisitDone, linkedinVisitFailed, linkedinInviteDone, linkedinInviteAccepted, linkedinInviteFailed, linkedinSent, linkedinOpened, linkedinReplied, linkedinInterested, linkedinNotInterested, linkedinSendFailed, manualInterested, manualNotInterested

Available options: all, imported, scanned, skipped, reviewed, contacted, hooked, attracted, warmed, interested, notInterested, emailsBounced, emailsUnsubscribed, failed, meetingBooked, paused, emailsSent, emailsOpened, emailsClicked, emailsReplied, emailsInterested, emailsNotInterested, emailsFailed, opportunitiesDone, aircallDone, aircallInterested, aircallNotInterested, apiDone, apiInterested, apiNotInterested, linkedinVisitDone, linkedinVisitFailed, linkedinInviteDone, linkedinInviteAccepted, linkedinInviteFailed, linkedinSent, linkedinOpened, linkedinReplied, linkedinInterested, linkedinNotInterested, linkedinSendFailed, manualInterested, manualNotInterested

format · enum<string>

Output format: 'json' or 'csv'. Default is CSV.

Available options: json, csv

Response

200

text/csv

Leads exported successfully