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
    }
  ]
}
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
    }
  ]
}