# SMS send history

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

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

`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](/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/sms/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": 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                                                     |