# Microsoft Teams send history

Retrieve daily event notification MS Teams delivery counts for a UTC calendar month.

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

`GET /app/notifications/teams/history`

Returns a dense daily series of **event notification MS Teams delivery counts** for one UTC calendar month. Counts match the event-notification portion of the combined integration delivery quota (history is tracked per channel).

Requires the `admin` or `subscriber` role and the **Outbound integrations** 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/teams/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 integrations feature entitlement                            |
|  `500` | Unexpected server error                                                     |