---
title: "GET Lists Collection"
method: GET
path: "/contact_lists"
tags: ["Contact Lists"]
---

# GET Lists Collection

`GET /contact_lists`

Use this method to return details about all contact lists for the account.
<div class="Msg"><p class="note-text">This method does not currently support filtering results using the contact list update date.</p></div>

## Query parameters

- `limit` integer
- `include_count` boolean
- `include_membership_count` 'all' | 'active'
- `name` string
- `status` 'all' | 'active' | 'deleted'
- `channel_type` 'email' | 'sms'
- `include_sms_membership_count` boolean

## Response `200`

Request successful

- ContactListArray
  - `lists` 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.
  - `lists_count` integer — The total number of contact lists.
  - `_links` PagingLinks
    - `next` Link
      - `href` string

## Other responses

- `400` — Bad request. Either the JSON was malformed or there was a data validation error.
- `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.
- `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/revisions/4b4a534c818d/schema)