---
title: "GET a List"
method: GET
path: "/contact_lists/{list_id}"
tags: ["Contact Lists"]
---

# GET a List

`GET /contact_lists/{list_id}`

Use this method to get details about a specific contact list (`list_id`).

## Path parameters

- `list_id` string, uuid, required

## Query parameters

- `include_membership_count` 'all' | 'active'

## Response `200`

Request successful

- ContactList
  - `list_id` string, uuid, required — Unique ID for the contact list
  - `name` string, required — The name given to the contact list
  - `description` string — Text describing the list.
  - `favorite` boolean — Identifies whether or not the account has favorited the contact list.
  - `created_at` string, date-time — System generated date and time that the resource was created, in ISO-8601 format.
  - `updated_at` string, date-time — Date and time that the list was last updated, in ISO-8601 format. System generated.
  - `deleted_at` string, date-time — If the list was deleted, this property shows the date and time it was deleted, in ISO-8601 format. System generated.
  - `membership_count` integer — The total number of contacts that are members in a list. Does not apply to segment type lists.

## Other responses

- `401` — The Access Token used is invalid.
- `403` — Forbidden request. You lack the necessary scopes, you lack the necessary user privileges, or the application is deactivated.
- `404` — The requested resource was not found.
- `500` — There was a problem with our internal service.
- `503` — Our internal service is temporarily unavailable.

---

[API](https://skmtc.net/cc/apis/appconnect-v3.md) · [All operations](https://skmtc.net/cc/apis/appconnect-v3/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/cc/appconnect-v3/versions/4b4a534c818d/schema)