# WhatsApp send history

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

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

`GET /app/notifications/whatsapp/history`

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

Requires the `admin` or `subscriber` role and the **WhatsApp 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/whatsapp/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": 3 }
  ],
  "total": 3,
  "navigation": {
    "canGoBack": true,
    "canGoForward": true,
    "previousMonth": "2026-05",
    "nextMonth": "2026-07"
  }
}
```

***

## Response fields
Same shape as [Email send history](/docs/api/notifications/email/history#response-fields).

***

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