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

# Get a Sending List

> Retrieve a single sending list by its ID.

Returns the full details of a single sending list, including an accurate count of active contacts.

## Path Parameters

<ParamField path="list_id" type="integer" required>
  The unique identifier of the sending list.
</ParamField>

## Response Fields

<ResponseField name="id" type="integer">
  Unique identifier for the sending list.
</ResponseField>

<ResponseField name="phone_number" type="string">
  The phone number associated with the list in E.164 format (e.g. `+12025551234`).
</ResponseField>

<ResponseField name="brand_name" type="string">
  The brand name registered for this sending list.
</ResponseField>

<ResponseField name="list_name" type="string">
  The display name of the sending list.
</ResponseField>

<ResponseField name="list_type" type="string">
  The SMS provider used for this list. One of: `lime`, `infobip`, `twilio`, `cm`, `aloware`.
</ResponseField>

<ResponseField name="status" type="string">
  Current status of the list. One of: `active`, `paused`, `suspended`, `deleted`.
</ResponseField>

<ResponseField name="contact_count" type="integer">
  The number of active contacts on this list. Calculated by counting the active ListContacts for this list.
</ResponseField>

<ResponseField name="created_at" type="datetime">
  ISO 8601 timestamp of when the list was created.
</ResponseField>

## Examples

<RequestExample>
  <CodeGroup>
    ```bash cURL theme={null}
    curl -X GET "https://api.tracklysms.com/api/v2/lists/42" \
      -H "X-Api-Key: trk_your_api_key_here"
    ```

    ```python Python theme={null}
    import requests

    response = requests.get(
        "https://api.tracklysms.com/api/v2/lists/42",
        headers={"X-Api-Key": "trk_your_api_key_here"}
    )

    data = response.json()
    print(f"{data['list_name']} — {data['contact_count']} contacts")
    ```

    ```javascript Node.js theme={null}
    const response = await fetch(
      "https://api.tracklysms.com/api/v2/lists/42",
      {
        headers: {
          "X-Api-Key": "trk_your_api_key_here",
        },
      }
    );

    const data = await response.json();
    console.log(data);
    ```
  </CodeGroup>
</RequestExample>

<ResponseExample>
  ```json 200 — Success theme={null}
  {
    "id": 42,
    "phone_number": "+12025551234",
    "brand_name": "Acme Co",
    "list_name": "Acme Promo List",
    "list_type": "twilio",
    "status": "active",
    "contact_count": 15230,
    "created_at": "2025-03-15T14:30:00"
  }
  ```

  ```json 404 — Not Found theme={null}
  {
    "error": "List not found",
    "code": "not_found"
  }
  ```

  ```json 401 — Unauthorized theme={null}
  {
    "error": "Invalid credentials",
    "code": "invalid_credentials"
  }
  ```
</ResponseExample>

## Error Codes

| HTTP Status | Error Code            | Description                                                                |
| ----------- | --------------------- | -------------------------------------------------------------------------- |
| 401         | `invalid_credentials` | API key is missing or invalid.                                             |
| 403         | `account_suspended`   | Your account is suspended. Resolve outstanding billing or contact support. |
| 429         | `rate_limited`        | Request throttled; retry with exponential backoff after the window resets. |
| 404         | `not_found`           | No sending list exists with the given ID, or the list has been deleted.    |

## Next Steps

<CardGroup cols={2}>
  <Card title="Contacts Overview" icon="users" href="/guides/contacts/overview">
    Manage contacts across your lists
  </Card>

  <Card title="List Contacts" icon="address-book" href="/api-reference/v2/contacts/list-contacts">
    View contacts on a specific list
  </Card>
</CardGroup>