Skip to main content
GET
/
v1
/
leads
/
{id}
curl https://api.sendpilot.ai/v1/leads/lead_abc123 \
  -H "X-API-Key: YOUR_API_KEY"

{
  "id": "lead_abc123",
  "linkedinUrl": "https://www.linkedin.com/in/john-doe",
  "status": "CONNECTION_ACCEPTED",
  "firstName": "John",
  "lastName": "Doe",
  "title": "VP of Engineering",
  "company": "TechCorp",
  "campaignId": "camp_xyz789",
  "createdAt": "2024-02-20T10:00:00.000Z",
  "updatedAt": "2024-02-23T15:30:00.000Z"
}

​
Request

​
X-API-Key
string
required
Your API key
​
id
string
required
The lead ID

​
Response

​
id
string
Unique lead identifier
​
linkedinUrl
string
LinkedIn profile URL of the lead
​
status
string
Current lead status
​
firstName
string
Lead’s first name (if available)
​
lastName
string
Lead’s last name (if available)
​
title
string
Lead’s job title (if available)
​
company
string
Lead’s company (if available)
​
campaignId
string
The campaign this lead belongs to
​
createdAt
string
ISO 8601 timestamp when the lead was added
​
updatedAt
string
ISO 8601 timestamp of last update
curl https://api.sendpilot.ai/v1/leads/lead_abc123 \
  -H "X-API-Key: YOUR_API_KEY"

{
  "id": "lead_abc123",
  "linkedinUrl": "https://www.linkedin.com/in/john-doe",
  "status": "CONNECTION_ACCEPTED",
  "firstName": "John",
  "lastName": "Doe",
  "title": "VP of Engineering",
  "company": "TechCorp",
  "campaignId": "camp_xyz789",
  "createdAt": "2024-02-20T10:00:00.000Z",
  "updatedAt": "2024-02-23T15:30:00.000Z"
}

Authorizations

​
X-API-Key
string
header
required

API key for authentication

Path Parameters

​
id
string
required

Lead ID

Response

Lead details

​
id
string
required
​
linkedinUrl
string
required
​
status
enum<string>
required
Available options:
PENDING,
CONNECTION_SENT,
CONNECTION_ACCEPTED,
MESSAGE_SENT,
REPLY_RECEIVED,
DONE
​
campaignId
string
required
​
createdAt
string<date-time>
required
​
updatedAt
string<date-time>
required
​
firstName
string | null
​
lastName
string | null
​
title
string | null
​
company
string | null