SMS send history — StatusDashboard Docs

GET /app/notifications/sms/history

Returns a dense daily series of event notification SMS send counts for one UTC calendar month. Counts match the same population as the monthly SMS message quota on Overview.

Requires the admin or subscriber role and the SMS 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/sms/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": 5 }
  ],
  "total": 5,
  "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`.
`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.
`navigation.previousMonth`	string \| null	Prior month (`YYYY-MM`) or `null`.
`navigation.nextMonth`	string \| null	Next month (`YYYY-MM`) or `null`.

Error responses

Status	When
`400`	Invalid `month` format, future month, or month outside the navigable window
`403`	Missing role or SMS feature entitlement
`500`	Unexpected server error