Docs
/
/
Contact supportLog inGet started
Overview
Client libraries
API keys
Authentication
Rate limits
Batch rate limits
Idempotent requests
Data retention
Bulk endpoints
Trigger data filtering
Pagination
Errors
Common error codes
Overview
Get user
List users
Identify user
Merge users
Delete user
List user messages
List user schedules
List user subscriptions
List user preference sets
Get user preference set
Update user preference set
Get channel data
Set channel data
Unset channel data
Get startedLog inContact support
Platform
Integrations
In-app UI
API reference
CLI reference
Management API
Developer tools
Tutorials

List user subscriptions

Retrieves a paginated list of subscriptions for a specific user, in descending order.

List user subscriptions

Retrieves a paginated list of subscriptions for a specific user, in descending order.

Endpoint

GET/v1/users/{user_id}/subscriptions

Rate limit

Tier 4

Path parameters

user_id
string

The user ID to list subscriptions for.

Query parameters

include[]
enum(string)[]

Associated resources to include in the response.

preferences
objects[]
RecipientReference[]

Only returns subscriptions for the specified object references.

after
string

The cursor to fetch entries after.

before
string

The cursor to fetch entries before.

page_size
integer

The number of items per page (defaults to 50).

Returns

ListSubscriptionsResponse

A response containing a list of subscriptions.

entries
Subscription[]

A list of subscriptions.

__typename
string
Required

The typename of the schema.

inserted_at
string(date-time)
Required

Timestamp when the resource was created.

object
Object
Required

A custom Object entity which belongs to a collection.

__typename
string
Required

The typename of the schema.

collection
string
Required

The collection this object belongs to.

created_at
string(date-time)

Timestamp when the resource was created.

id
string
Required

Unique identifier for the object.

properties
object(any)

The custom properties associated with the object.

updated_at
string(date-time)
Required

The timestamp when the resource was last updated.

properties
object(any)

The custom properties associated with the subscription relationship.

recipient
2 possible types
Required

A recipient of a notification, which is either a user or an object.

updated_at
string(date-time)
Required

The timestamp when the resource was last updated.

page_info
PageInfo

Pagination information for a list of resources.

__typename
string

The typename of the schema.

after
string

The cursor to fetch entries after.

before
string

The cursor to fetch entries before.

page_size
integer

The number of items per page (defaults to 50).

New chat