> ## Documentation Index
> Fetch the complete documentation index at: https://api.smartlead.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Get All Lead Lists

> Retrieve all lead lists with optional filtering and pagination

## Query Parameters

<ParamField query="api_key" type="string" required>
  Your SmartLead API key
</ParamField>

<ParamField query="listName" type="string">
  Filter by list name (partial match)
</ParamField>

<ParamField query="tagIds" type="string">
  Comma-separated tag IDs to filter by (e.g., `1,2,3`)
</ParamField>

<ParamField query="limit" type="number">
  Number of lists to return. Range: 1-1000. Default: 10
</ParamField>

<ParamField query="offset" type="number">
  Number of records to skip for pagination. Minimum: 0. Default: 0
</ParamField>

<RequestExample>
  ```bash cURL theme={null}
  curl "https://server.smartlead.ai/api/v1/lead-list/?api_key=YOUR_KEY&limit=20&offset=0"
  ```
</RequestExample>

## Response Codes

<ResponseField name="200" type="Success">
  Request successful
</ResponseField>

<ResponseField name="400" type="Bad Request">
  Invalid request parameters or malformed request body
</ResponseField>

<ResponseField name="401" type="Unauthorized">
  Invalid or missing API key
</ResponseField>

<ResponseField name="422" type="Validation Error">
  Request validation failed. Check parameter types and constraints.
</ResponseField>

<ResponseExample>
  ```json 200 - Success theme={null}
  {
    "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"
      }
    ]
  }
  ```

  ```json 401 - Unauthorized theme={null}
  {
    "message": "Invalid API Key"
  }
  ```
</ResponseExample>