---
title: "Get list subscriptions"
method: GET
path: "/profiles/{user_id}/lists"
tags: ["User Profiles"]
---

# Get list subscriptions

`GET /profiles/{user_id}/lists`

Returns the lists a user is subscribed to, with paging. Use it to check what a recipient will receive before sending to a list.

## Path parameters

- `user_id` string, required

## Query parameters

- `cursor` string, nullable

## Response `200`

- GetListSubscriptionsResponse
  - `paging` Paging, required
    - `cursor` string, nullable
    - `more` boolean, required
  - `results` GetListSubscriptionsItem[], required — An array of lists
    - `id` string, required
    - `name` string, required — List name
    - `created` string, required — The date/time of when the list was created. Represented as a string in ISO format.
    - `updated` string, required — The date/time of when the list was updated. Represented as a string in ISO format.
    - `preferences` RecipientPreferences
      - `categories` NotificationPreferences
      - `notifications` NotificationPreferences

## Other responses

- `400`

---

[API](https://skmtc.net/trycourier/apis/courier.md) · [All operations](https://skmtc.net/trycourier/apis/courier/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/trycourier/courier/versions/04f69fbf96a5/schema)