# List Analytics Publications

See a page's publications: who each one sends to, where, and when it sends next. Only the page's owner can list them.

`GET https://connect.mindcloud.co/v2/analytics/pages/:pageId/publications`

Permissions: `analytics:page:view`.

## Parameters

### Path

- `pageId` (string, required): The page id, from List Analytics Pages.

### Headers

- `X-Company-Id` (string): Optional. The id of the organization to act in. Leave it out to act in the API key's own organization. Here a key acts in another organization only as one of its members: with "Use this key across all of your organizations" on, in an organization its creator belongs to with a role. Child organizations and MindCloud staff access do not reach this endpoint. Every response's X-Company-Id header names the organization it acted in. See [Organizations](https://mindcloud.co/docs/api/rest/introduction/organizations).

## Example request

```bash
curl --request GET \
  --url 'https://connect.mindcloud.co/v2/analytics/pages/Pq7Lm2Xc9RtA/publications' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN'
```

## Response fields

- `id` (string): The publication's id.
- `pageId` (string): The page it sends, from List Analytics Pages.
- `name` (string): Its name. Null until one is given.
- `isActive` (boolean): True when it sends on its schedule. A new publication starts paused.
- `channel` (string): Where it sends.
  Allowed values:
    - `email`: Email to the recipients, from MindCloud or from a Gmail or Outlook connection.
    - `slack`: A message in a Slack channel, sent with a Slack connection.
    - `teams`: A message in a Microsoft Teams channel, sent with a Microsoft Teams connection.
- `scheduleType` (string): How its schedule is set.
  Allowed values:
    - `fixed`: On the weekdays in days, at each time in runTimes.
    - `interval`: Every intervalMinutes, starting at the first time in runTimes.
    - `monthly`: On the days of the month in monthDays, at each time in runTimes.
    - `once`: Once, on the date in runDates, at the time in runTimes.
- `intervalMinutes` (number): For interval: minutes between sends, 360 (six hours) to 43200 (thirty days).
- `days` (array of number): For fixed: the weekdays it sends on, 0 (Sunday) to 6 (Saturday).
- `monthDays` (array of number): For monthly: the days of the month it sends on, 1 to 30, or -1 for the last day.
- `runDates` (array of string): For once: the date it sends on, as YYYY-MM-DD.
- `runTimes` (array of string): The times of day it sends at, as HH:MM in timeZone.
- `timeZone` (string): The IANA time zone its times are in, such as America/New_York.
- `isOrganizationTimeZone` (boolean): True when timeZone is the organization's time zone and changes with it; false when one was set for this publication.
- `nextRunOn` (date): When it sends next. Null while it is paused or has nothing left to send.
- `autoPausedOn` (date): When MindCloud paused it after failed sends. Null when it was not.
- `autoPauseReason` (string): Why MindCloud paused it. Null when it was not.
- `recipientUserIds` (array of string): Member recipients, by user id (from List Members).
- `externalRecipients` (array of string): Recipients outside the organization, by email address.
- `unsubscribedRecipientUserIds` (array of string): Members who unsubscribed with the link in its email, by user id. They get nothing until resubscribed.
- `unsubscribedExternalRecipients` (array of string): Outside addresses that unsubscribed with the link in its email.
- `subject` (string): The email subject. Null uses the page's name.
- `connectionId` (string): The connection it sends through, from List Connections. Null for email from MindCloud's own sender.
- `destination` (object): For slack and teams: where it posts. Null for email.
  - `channelId` (string): Slack and Teams: the channel id it posts in. Null for email.
  - `channelLabel` (string): Slack and Teams: the channel name, as picked. Null for email.
  - `teamId` (string): Teams: the team id. Null otherwise.
  - `teamLabel` (string): Teams: the team name, as picked. Null otherwise.
- `variables` (object): Its own filter values, by page variable name, as the page's link carries them. Empty uses the page's defaults.
- `createdOn` (date): When it was created.
- `updatedOn` (date): When it last changed.