Email send history — StatusDashboard Docs

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 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

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

Sample response

Status: 200 OK

{
  "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