curl "https://server.smartlead.ai/api/v1/leads/55501/campaign-overview?api_key=YOUR_KEY"
import requests
response = requests.get(
"https://server.smartlead.ai/api/v1/leads/55501/campaign-overview",
params={"api_key": "YOUR_API_KEY"}
)
for mapping in response.json()["data"]["email_campaign_leads_mappings"]:
print(mapping["email_campaign"]["name"], mapping["status"], mapping["current_seq_num"])
{
"ok": true,
"message": "Campaign lead overview fetched successfully",
"data": {
"id": 55501,
"email": "john.doe@acme.com",
"last_name": "Doe",
"first_name": "John",
"phone_number": null,
"company_name": "Acme",
"website": "https://acme.com",
"company_url": "acme.com",
"location": null,
"custom_fields": {},
"linkedin_profile": null,
"esp_domain_type": 1,
"email_campaign_leads_mappings": [
{
"id": "987654",
"status": "INPROGRESS",
"lead_category_id": null,
"revenue": null,
"current_seq_num": "2",
"next_timestamp_to_reach": "2026-09-30T09:00:00+00:00",
"email_campaign_id": "123",
"email_account_id": "321",
"is_active": true,
"email_campaign": {
"id": "123",
"name": "Q4 Outreach",
"status": "ACTIVE",
"sequence_count": 3
}
}
]
}
}
{
"ok": false,
"message": "Error fetching campaign lead overview"
}
Lead Management
Get Lead Campaign Overview
Get a lead’s details and every campaign it is in, with its status and current sequence step in each
GET
/
api
/
v1
/
leads
/
{leadId}
/
campaign-overview
curl "https://server.smartlead.ai/api/v1/leads/55501/campaign-overview?api_key=YOUR_KEY"
import requests
response = requests.get(
"https://server.smartlead.ai/api/v1/leads/55501/campaign-overview",
params={"api_key": "YOUR_API_KEY"}
)
for mapping in response.json()["data"]["email_campaign_leads_mappings"]:
print(mapping["email_campaign"]["name"], mapping["status"], mapping["current_seq_num"])
{
"ok": true,
"message": "Campaign lead overview fetched successfully",
"data": {
"id": 55501,
"email": "john.doe@acme.com",
"last_name": "Doe",
"first_name": "John",
"phone_number": null,
"company_name": "Acme",
"website": "https://acme.com",
"company_url": "acme.com",
"location": null,
"custom_fields": {},
"linkedin_profile": null,
"esp_domain_type": 1,
"email_campaign_leads_mappings": [
{
"id": "987654",
"status": "INPROGRESS",
"lead_category_id": null,
"revenue": null,
"current_seq_num": "2",
"next_timestamp_to_reach": "2026-09-30T09:00:00+00:00",
"email_campaign_id": "123",
"email_account_id": "321",
"is_active": true,
"email_campaign": {
"id": "123",
"name": "Q4 Outreach",
"status": "ACTIVE",
"sequence_count": 3
}
}
]
}
}
{
"ok": false,
"message": "Error fetching campaign lead overview"
}
Get
leadId from Get Lead by Email. Each item in email_campaign_leads_mappings is one campaign the lead is in. Its id is the lead map ID used by Get Lead Sequence Details. For inactive mappings (is_active: false), status, revenue, current_seq_num, next_timestamp_to_reach, email_campaign_id and email_account_id are returned as "XXX".Path Parameters
number
required
Lead ID
Query Parameters
string
required
Your SmartLead API key (client API keys are not allowed)
curl "https://server.smartlead.ai/api/v1/leads/55501/campaign-overview?api_key=YOUR_KEY"
import requests
response = requests.get(
"https://server.smartlead.ai/api/v1/leads/55501/campaign-overview",
params={"api_key": "YOUR_API_KEY"}
)
for mapping in response.json()["data"]["email_campaign_leads_mappings"]:
print(mapping["email_campaign"]["name"], mapping["status"], mapping["current_seq_num"])
Response
object
The lead (
id, email, first_name, last_name, phone_number, company_name, website, company_url, location, custom_fields, linkedin_profile, esp_domain_type) and email_campaign_leads_mappings.Show email_campaign_leads_mappings items
Show email_campaign_leads_mappings items
string
Lead map ID
string
Lead status in the campaign
number | null
Lead category ID
string | null
Revenue
string
Current sequence step number
string | null
Next scheduled send time
string
Campaign ID
string | null
Assigned email account ID
boolean
Whether the mapping is active
object
id (string), name, status, sequence_count (number of sequence steps){
"ok": true,
"message": "Campaign lead overview fetched successfully",
"data": {
"id": 55501,
"email": "john.doe@acme.com",
"last_name": "Doe",
"first_name": "John",
"phone_number": null,
"company_name": "Acme",
"website": "https://acme.com",
"company_url": "acme.com",
"location": null,
"custom_fields": {},
"linkedin_profile": null,
"esp_domain_type": 1,
"email_campaign_leads_mappings": [
{
"id": "987654",
"status": "INPROGRESS",
"lead_category_id": null,
"revenue": null,
"current_seq_num": "2",
"next_timestamp_to_reach": "2026-09-30T09:00:00+00:00",
"email_campaign_id": "123",
"email_account_id": "321",
"is_active": true,
"email_campaign": {
"id": "123",
"name": "Q4 Outreach",
"status": "ACTIVE",
"sequence_count": 3
}
}
]
}
}
{
"ok": false,
"message": "Error fetching campaign lead overview"
}
