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