Skip to main content
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"
    }
  ]
}

​
Query Parameters

​
api_key
string
required
Your SmartLead API key
​
listName
string
Filter by list name (partial match)
​
tagIds
string
Comma-separated tag IDs to filter by (e.g., 1,2,3)
​
limit
number
Number of lists to return. Range: 1-1000. Default: 10
​
offset
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

​
200
Success
Request successful
​
400
Bad Request
Invalid request parameters or malformed request body
​
401
Unauthorized
Invalid or missing API key
​
422
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"
    }
  ]
}