# List Analytics Publication Runs

See a publication's delivery history, newest first. Filter by status to find the failed sends, or by manual for Send now.

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

Permissions: `analytics:page:view`.

## Parameters

### Path

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

### 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/Pb5Ty3Ws7KdM/runs' \
  --header 'Authorization: Bearer $MINDCLOUD_API_TOKEN'
```

## Response fields

- `id` (string): The send's id.
- `publicationId` (string): The publication it sent, from List Analytics Publications.
- `pageId` (string): The page it sent, from List Analytics Pages.
- `isManual` (boolean): True for a Send now, false for a scheduled send.
- `status` (string): How it went.
  Allowed values:
    - `claimed`: Starting.
    - `sending`: Being delivered.
    - `sent`: Delivered.
    - `failed`: Could not be delivered; errorCode and errorMessage say why.
    - `missed`: Its scheduled time passed without a send.
- `statusOn` (date): When it reached its status.
- `recipientCount` (number): How many members it went to. Null before it is delivered.
- `externalRecipientCount` (number): How many outside addresses it went to. Null before it is delivered or with none.
- `errorCode` (string): Why it failed. Null unless it failed.
- `errorMessage` (string): What went wrong, in words. Null unless it failed.
- `createdOn` (date): When it started.