---
title: "Get marketing subscriptions"
method: GET
path: "/messenger/1/pages/{pageId}/subscriptions"
tags: ["channels", "messenger", "marketing-subscriptions-messenger"]
---

# Get marketing subscriptions

`GET /messenger/1/pages/{pageId}/subscriptions`

## Request

- Base URL: `https://api.infobip.com` (the document declares no server; this is the origin it was published from)
- URL: `https://api.infobip.com/messenger/1/pages/{pageId}/subscriptions`
- Auth: one of:
  - OAuth 2
    - Client credentials
    - Token URL: `https://api.infobip.com/auth/1/oauth2/token`
  - API key in header `Authorization`
  - API key in header `Authorization`
  - HTTP basic

Get all messenger marketing subscriptions for single page. For pages with many subscriptions, set `useCursor=true` and follow `nextCursor` to fetch them page by page. <br/> Collecting subscription tokens still works on the Messenger platform. However, marketing messages on Messenger are no longer available for new users. For existing users, this feature will be deprecated on January 12, 2026. After this date, marketing messages will no longer be supported.

## Path parameters

- `pageId` string, required

## Query parameters

- `customAudienceIds` string[]
- `useCursor` boolean
- `limit` integer
- `cursor` string

## Response `200`

List Of Marketing Subscriptions For Page. With `useCursor=true`, one page of subscriptions and the cursor for the next page.

- union
  - Cc99cb7b0e48638be90df2dee94fb1aaadb95bcd09a6944a79bd00ca6a59df77PageMarketingSubscriptionResponse[]
    - `notificationMessagesToken` string, required: Token that represents the person. It is used to send Marketing Messages.
    - `recipientId` string: Page-scoped user/recipient ID.
    - `notificationMessagesReoptin` 'ENABLED' | 'DISABLED' | 'UNKNOWN': Is Reoptin ENABLED or DISABLED.
    - `creationDatetime` string, date-time: Creation Datetime.
    - `tokenExpiry` string, date-time: Date when the notification message token expires.
    - `userTokenStatus` 'REFRESHED' | 'NOT_REFRESHED' | 'UNKNOWN': Status of notification. This field is present only when the user stops or resumes Marketing Messages.
    - `title` string: Title.
    - `notificationMessagesTimezone` string: Timezone for the person receiving the message.
    - `nextEligibleDatetime` string, date-time: The date on which it will be possible to send the next message.
    - `customAudienceIds` string[]: Meta Custom Audience IDs associated with the subscription token.
  - Cc99cb7b0e48638be90df2dee94fb1aaadb95bcd09a6944a79bd00ca6a59df77PagedMarketingSubscriptionsResponse
    - `results` Cc99cb7b0e48638be90df2dee94fb1aaadb95bcd09a6944a79bd00ca6a59df77PageMarketingSubscriptionResponse[], required: The list of the results for this page.
      - `notificationMessagesToken` string, required: Token that represents the person. It is used to send Marketing Messages.
      - `recipientId` string: Page-scoped user/recipient ID.
      - `notificationMessagesReoptin` 'ENABLED' | 'DISABLED' | 'UNKNOWN': Is Reoptin ENABLED or DISABLED.
      - `creationDatetime` string, date-time: Creation Datetime.
      - `tokenExpiry` string, date-time: Date when the notification message token expires.
      - `userTokenStatus` 'REFRESHED' | 'NOT_REFRESHED' | 'UNKNOWN': Status of notification. This field is present only when the user stops or resumes Marketing Messages.
      - `title` string: Title.
      - `notificationMessagesTimezone` string: Timezone for the person receiving the message.
      - `nextEligibleDatetime` string, date-time: The date on which it will be possible to send the next message.
      - `customAudienceIds` string[]: Meta Custom Audience IDs associated with the subscription token.
    - `cursor` Cc99cb7b0e48638be90df2dee94fb1aaadb95bcd09a6944a79bd00ca6a59df77CursorPageInfo, required: Cursor information.
      - `limit` integer: Requested limit.
      - `nextCursor` string: The `cursor` value you will use in your next request to fetch the subsequent set of results.

## Other responses

- `400`: Bad Request
- `401`: Unauthorized
- `403`: Forbidden
- `404`: Page Does Not Exist
- `429`: Too Many Requests
- `500`: Internal Server Error

---

[API](https://skmtc.dev/infobip/apis/infobip-openapi-specification.md) - [All operations](https://skmtc.dev/infobip/apis/infobip-openapi-specification/llms.txt) - [OpenAPI document](https://skmtc.dev/infobip/apis/infobip-openapi-specification/revisions/9dcbbaf902de?raw)