# Email send history

Retrieve daily event notification email send counts for a UTC calendar month.

Source: https://statusdashboard.com/docs/api/notifications/email/history

`GET /app/notifications/email/history`

Returns a dense daily series of **event notification email send counts** for one UTC calendar month. Counts match the same population as the monthly email message quota on **Overview** (subscription verify/manage emails are excluded).

Requires the `admin` or `subscriber` role and the **Email notifications** feature entitlement.

***

## Request
See [API Basics](/docs/api) for required headers.

### Query parameters
| Parameter | Type   | Required | Description                                                                                                                                              |
| --------- | ------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `month`   | string | No       | UTC calendar month in `YYYY-MM` format. Defaults to the current UTC month. Must be within the navigable window (current month plus the prior 12 months). |

***

## Sample request
```bash
curl "https://api.statusdashboard.com/app/notifications/email/history?month=2026-06" \
  -H "Authorization: Bearer bcf847abf5c6:def456"
```

## Sample response
**Status: `200 OK`**

```json
{
  "month": "2026-06",
  "timezone": "UTC",
  "days": [
    { "date": "2026-06-01", "count": 0 },
    { "date": "2026-06-02", "count": 14 },
    { "date": "2026-06-03", "count": 0 }
  ],
  "total": 14,
  "navigation": {
    "canGoBack": true,
    "canGoForward": true,
    "previousMonth": "2026-05",
    "nextMonth": "2026-07"
  }
}
```

***

## Response fields
| Field                      | Type           | Description                                                                                                                           |
| -------------------------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------- |
| `month`                    | string         | Resolved UTC calendar month (`YYYY-MM`).                                                                                              |
| `timezone`                 | string         | Always `"UTC"`.                                                                                                                       |
| `days`                     | array          | Dense list of every calendar day in the month (28–31 entries). Missing days are returned with `count: 0`. Sorted ascending by `date`. |
| `days[].date`              | string         | UTC calendar day (`YYYY-MM-DD`).                                                                                                      |
| `days[].count`             | integer        | Non-negative send count for that day.                                                                                                 |
| `total`                    | integer        | Sum of all `days[].count` values.                                                                                                     |
| `navigation.canGoBack`     | boolean        | `true` when `previousMonth` is within the navigable window.                                                                           |
| `navigation.canGoForward`  | boolean        | `true` when `nextMonth` is within the navigable window (never `true` when viewing the current UTC month).                             |
| `navigation.previousMonth` | string \| null | Prior month (`YYYY-MM`) or `null` when back navigation is unavailable.                                                                |
| `navigation.nextMonth`     | string \| null | Next month (`YYYY-MM`) or `null` when forward navigation is unavailable.                                                              |

***

## Error responses
| Status | When                                                                                 |
| -----: | ------------------------------------------------------------------------------------ |
|  `400` | Invalid `month` format, future month, or month outside the 13-month navigable window |
|  `403` | Missing role or email feature entitlement                                            |
|  `500` | Unexpected server error                                                              |