Skip to main content
GET
/
profiles
/
{user_id}
/
lists
JavaScript
import Courier from '@trycourier/courier';

const client = new Courier({
  apiKey: process.env['COURIER_API_KEY'], // This is the default and can be omitted
});

const list = await client.profiles.lists.retrieve('user_id');

console.log(list.paging);
{
  "paging": {
    "cursor": "MTpFWUNFRkRRN0c1WERTRTU2",
    "more": true
  },
  "results": [
    {
      "id": "example.list.id",
      "name": "Example List",
      "created": "2024-01-15T10:30:00.000Z",
      "updated": "2024-01-15T10:30:00.000Z",
      "preferences": {
        "categories": {
          "categories_key": {
            "status": "OPTED_IN",
            "rules": [
              {
                "start": "string",
                "until": "string"
              }
            ],
            "channel_preferences": [
              {
                "channel": "direct_message"
              }
            ]
          }
        },
        "notifications": {
          "notifications_key": {
            "status": "OPTED_IN",
            "rules": [
              {
                "start": "string",
                "until": "string"
              }
            ],
            "channel_preferences": [
              {
                "channel": "direct_message"
              }
            ]
          }
        }
      }
    }
  ]
}

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Path Parameters

user_id
string
required

A unique identifier representing the user associated with the requested user profile.

Query Parameters

cursor
string | null

A unique identifier that allows for fetching the next set of message statuses.

Response

paging
Paging · object
required
results
GetListSubscriptionsItem · object[]
required

An array of lists