---
title: "List contact lists"
method: GET
path: "/contact-lists"
tags: ["ContactLists"]
---

# List contact lists

`GET /contact-lists`

## Request

- Base URL: `https://api.supersendtx.com`
- URL: `https://api.supersendtx.com/contact-lists`
- Auth: HTTP bearer

## Query parameters

- `limit` integer
- `cursor` string

## Response `200`

Contact lists

- ListContactListsResponse
  - `data` ContactList[], required
    - `id` string, required
    - `name` string, required
    - `key` string, required: URL-safe slug derived from the name, stable once created
    - `description` string, nullable, required
    - `contact_count` integer, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `has_more` boolean, required
  - `next_cursor` string, nullable, required

## Other responses

- `400`: Invalid cursor
- `401`: Missing or invalid API key

---

[API](https://skmtc.dev/ranla/apis/supersend-tx-api.md) · [All operations](https://skmtc.dev/ranla/apis/supersend-tx-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ranla/apis/supersend-tx-api/revisions/e3e782652f50?raw)