---
title: "Get a single sending list by ID"
method: GET
path: "/v2/lists/{list_id}"
tags: ["lists-v2"]
---

# Get a single sending list by ID

`GET /v2/lists/{list_id}`

## Request

- Base URL: `https://api.tracklysms.com/api`
- URL: `https://api.tracklysms.com/api/v2/lists/{list_id}`
- Auth: API key in header `X-Api-Key`

## Response `200`

Success

- ListResponse
  - `brand_name` string: Brand name
  - `contact_count` integer: Number of contacts in list
  - `created_at` string, date-time: Creation timestamp
  - `id` integer: Sending list ID
  - `list_name` string: List name
  - `list_type` string: Provider type: lime, infobip, twilio, cm, aloware
  - `phone_number` string: Sending phone number (E.164)
  - `status` string: Status: active, paused, suspended, deleted

## Other responses

- `401`: Authentication error
- `404`: List not found

---

[API](https://skmtc.dev/tracklysms/apis/trackly-sms-api.md) · [All operations](https://skmtc.dev/tracklysms/apis/trackly-sms-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tracklysms/apis/trackly-sms-api/revisions/ac1ad22cb2a9?raw)