Skip to main content
GET
/
api
/
v1
/
leads
curl "https://server.smartlead.ai/api/v1/leads/?api_key=YOUR_KEY&email=john@example.com"

{
  "id": 2995276770,
  "first_name": "John",
  "last_name": "Doe",
  "email": "john@example.com",
  "phone_number": "+1234567890",
  "company_name": "Acme Corp",
  "website": "https://acme.com",
  "location": "San Francisco, CA",
  "linkedin_profile": "https://linkedin.com/in/johndoe",
  "company_url": "https://acme.com",
  "custom_fields": {
    "job_title": "CEO",
    "industry": "Technology"
  },
  "is_unsubscribed": false,
  "unsubscribed_client_id_map": null,
  "created_at": "2025-11-25T12:54:54.000Z",
  "lead_campaign_data": [
    {
      "campaign_lead_map_id": 2433664091,
      "campaign_id": 123,
      "campaign_name": "Q4 Outreach",
      "client_id": 456,
      "client_email": "user@company.com",
      "lead_category_id": 789
    }
  ]
}

Documentation Index

Fetch the complete documentation index at: https://api.smartlead.ai/llms.txt

Use this file to discover all available pages before exploring further.

Returns lead details including personal information, custom fields, and all campaigns the lead is enrolled in. Returns empty object if lead not found.

​
Query Parameters

​
api_key
string
required
Your SmartLead API key
​
email
string
required
The email address to search for
curl "https://server.smartlead.ai/api/v1/leads/?api_key=YOUR_KEY&email=john@example.com"

​
Response Fields

​
id
number
Unique lead identifier
​
email
string
Lead’s email address
​
first_name
string
Lead’s first name
​
last_name
string
Lead’s last name
​
phone_number
string
Lead’s phone number
​
company_name
string
Company name
​
website
string
Company website
​
location
string
Lead’s location
​
linkedin_profile
string
LinkedIn profile URL
​
company_url
string
Company URL
​
custom_fields
object
Custom fields object containing personalization data
​
is_unsubscribed
boolean
Whether the lead is globally unsubscribed
​
unsubscribed_client_id_map
object
Map of client IDs where lead is unsubscribed
​
created_at
timestamp
ISO 8601 timestamp of when the lead was created
​
lead_campaign_data
array
Array of campaigns this lead is enrolled in

​
Response Codes

​
200
Success
Lead retrieved successfully (returns empty object if not found)
​
401
Unauthorized
Invalid or missing API key
​
422
Validation Error
Missing or invalid email parameter
​
500
Internal Server Error
Server error occurred
{
  "id": 2995276770,
  "first_name": "John",
  "last_name": "Doe",
  "email": "john@example.com",
  "phone_number": "+1234567890",
  "company_name": "Acme Corp",
  "website": "https://acme.com",
  "location": "San Francisco, CA",
  "linkedin_profile": "https://linkedin.com/in/johndoe",
  "company_url": "https://acme.com",
  "custom_fields": {
    "job_title": "CEO",
    "industry": "Technology"
  },
  "is_unsubscribed": false,
  "unsubscribed_client_id_map": null,
  "created_at": "2025-11-25T12:54:54.000Z",
  "lead_campaign_data": [
    {
      "campaign_lead_map_id": 2433664091,
      "campaign_id": 123,
      "campaign_name": "Q4 Outreach",
      "client_id": 456,
      "client_email": "user@company.com",
      "lead_category_id": 789
    }
  ]
}