curl "https://server.smartlead.ai/api/v1/lead-list/?api_key=YOUR_KEY&limit=20&offset=0"
{
"ok": true,
"data": [
{
"id": 500,
"name": "Q1 2025 Enterprise Prospects",
"lead_count": 1250,
"created_at": "2025-12-01T10:00:00.000Z"
},
{
"id": 501,
"name": "SMB Tech Companies",
"lead_count": 850,
"created_at": "2025-12-05T14:00:00.000Z"
}
]
}
{
"message": "Invalid API Key"
}
Lead Lists
Get All Lead Lists
Retrieve all lead lists with optional filtering and pagination
GET
/
api
/
v1
/
lead-list
/
curl "https://server.smartlead.ai/api/v1/lead-list/?api_key=YOUR_KEY&limit=20&offset=0"
{
"ok": true,
"data": [
{
"id": 500,
"name": "Q1 2025 Enterprise Prospects",
"lead_count": 1250,
"created_at": "2025-12-01T10:00:00.000Z"
},
{
"id": 501,
"name": "SMB Tech Companies",
"lead_count": 850,
"created_at": "2025-12-05T14:00:00.000Z"
}
]
}
{
"message": "Invalid API Key"
}
Query Parameters
string
required
Your SmartLead API key
string
Filter by list name (partial match)
string
Comma-separated tag IDs to filter by (e.g.,
1,2,3)number
Number of lists to return. Range: 1-1000. Default: 10
number
Number of records to skip for pagination. Minimum: 0. Default: 0
curl "https://server.smartlead.ai/api/v1/lead-list/?api_key=YOUR_KEY&limit=20&offset=0"
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"
},
{
"id": 501,
"name": "SMB Tech Companies",
"lead_count": 850,
"created_at": "2025-12-05T14:00:00.000Z"
}
]
}
{
"message": "Invalid API Key"
}