---
title: "Retrieve a contact list"
method: GET
path: "/contact-lists/{id}"
tags: ["ContactLists"]
---

# Retrieve a contact list

`GET /contact-lists/{id}`

## Request

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

## Path parameters

- `id` string, required

## Response `200`

Contact list

- ContactListResponse
  - `list` 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

## Other responses

- `401`: Missing or invalid API key
- `404`: Contact list not found

---

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