curl "https://server.smartlead.ai/api/v1/leads/789?api_key=YOUR_KEY"
import requests
response = requests.get(
"https://server.smartlead.ai/api/v1/leads/789",
params={"api_key": "YOUR_API_KEY"}
)
lead = response.json()
print(f"Lead: {lead['email']}")
print(f"Status: {lead['status']}")
print(f"Category: {lead.get('category_name', 'Uncategorized')}")
{
"id": 789,
"email": "john@company.com",
"first_name": "John",
"last_name": "Doe",
"company_name": "ACME Corp",
"status": "INPROGRESS",
"category_id": 1,
"category_name": "Interested",
"email_stats": {
"is_opened": true,
"is_clicked": true,
"is_replied": true
},
"custom_fields": {
"job_title": "CEO"
}
}
Campaign Leads
Get Lead by ID
Retrieve detailed information about a specific lead
GET
/
api
/
v1
/
leads
/
{lead_id}
curl "https://server.smartlead.ai/api/v1/leads/789?api_key=YOUR_KEY"
import requests
response = requests.get(
"https://server.smartlead.ai/api/v1/leads/789",
params={"api_key": "YOUR_API_KEY"}
)
lead = response.json()
print(f"Lead: {lead['email']}")
print(f"Status: {lead['status']}")
print(f"Category: {lead.get('category_name', 'Uncategorized')}")
{
"id": 789,
"email": "john@company.com",
"first_name": "John",
"last_name": "Doe",
"company_name": "ACME Corp",
"status": "INPROGRESS",
"category_id": 1,
"category_name": "Interested",
"email_stats": {
"is_opened": true,
"is_clicked": true,
"is_replied": true
},
"custom_fields": {
"job_title": "CEO"
}
}
Get complete lead details including contact info, engagement stats, category, and custom fields. This is a global lead lookup across all campaigns.
Path Parameters
number
required
Lead ID
Query Parameters
string
required
Your SmartLead API key
curl "https://server.smartlead.ai/api/v1/leads/789?api_key=YOUR_KEY"
import requests
response = requests.get(
"https://server.smartlead.ai/api/v1/leads/789",
params={"api_key": "YOUR_API_KEY"}
)
lead = response.json()
print(f"Lead: {lead['email']}")
print(f"Status: {lead['status']}")
print(f"Category: {lead.get('category_name', 'Uncategorized')}")
Response Example
{
"id": 789,
"email": "john@company.com",
"first_name": "John",
"last_name": "Doe",
"company_name": "ACME Corp",
"status": "INPROGRESS",
"category_id": 1,
"category_name": "Interested",
"email_stats": {
"is_opened": true,
"is_clicked": true,
"is_replied": true
},
"custom_fields": {
"job_title": "CEO"
}
}
