---
title: "Get account-owned sending lists and contact counts, optionally paginated"
method: GET
path: "/v2/lists"
tags: ["lists-v2"]
---

# Get account-owned sending lists and contact counts, optionally paginated

`GET /v2/lists`

## Request

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

## Query parameters

- `cursor` string
- `limit` integer
- `status` string

## Response `200`

Success

- ListsResponse
  - `lists` ListResponse[]: Array of lists
    - `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
  - `pagination` SendingListPagination
    - `has_more` boolean: Whether another page exists
    - `limit` integer: Requested page size, from 1 to 100
    - `next_cursor` string, nullable: Opaque cursor for the next page, or null on the last page

## Other responses

- `400`: Invalid pagination or paginated status filter
- `401`: Authentication error

---

[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)