curl "https://server.smartlead.ai/api/v1/lead-list/500?api_key=YOUR_KEY"
{
"ok": true,
"data": {
"id": 500,
"name": "Q1 2025 Enterprise Prospects",
"lead_count": 1250,
"created_at": "2025-12-01T10:00:00.000Z",
"updated_at": "2025-12-10T16:30:00.000Z"
}
}
{
"message": "Invalid API Key"
}
Lead Lists
Get Lead List by ID
Retrieve details of a specific lead list by its ID
GET
/
api
/
v1
/
lead-list
/
{id}
curl "https://server.smartlead.ai/api/v1/lead-list/500?api_key=YOUR_KEY"
{
"ok": true,
"data": {
"id": 500,
"name": "Q1 2025 Enterprise Prospects",
"lead_count": 1250,
"created_at": "2025-12-01T10:00:00.000Z",
"updated_at": "2025-12-10T16:30:00.000Z"
}
}
{
"message": "Invalid API Key"
}
Path Parameters
number
required
The unique ID of the lead list
curl "https://server.smartlead.ai/api/v1/lead-list/500?api_key=YOUR_KEY"
Response Codes
Success
Request successful
Bad Request
Invalid request parameters or malformed request body
Unauthorized
Invalid or missing API key
Validation Error
Request validation failed. Check parameter types and constraints.
{
"ok": true,
"data": {
"id": 500,
"name": "Q1 2025 Enterprise Prospects",
"lead_count": 1250,
"created_at": "2025-12-01T10:00:00.000Z",
"updated_at": "2025-12-10T16:30:00.000Z"
}
}
{
"message": "Invalid API Key"
}