---
title: "Email statistics"
method: GET
path: "/v1/email-sends/stats"
tags: ["Email"]
---

# Email statistics

`GET /v1/email-sends/stats`

## Request

- Base URL: `https://api-eu.dynamicdocumentapi.com`
- URL: `https://api-eu.dynamicdocumentapi.com/v1/email-sends/stats`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

Today's recipients of live emails in this region against the daily cap (it resets at 00:00 UTC), and the sends of the last 30 days by status.

## Response `200`

- EmailStats
  - `last_30_days` object, required: Sends created in the last 30 days, by status.
    - `canceled` integer
    - `failed` integer
    - `sandboxed` integer
    - `sent` integer
    - `skipped` integer
    - `unknown` integer
  - `object` 'email_stats', required
  - `today` object, required: Recipients of live emails today (UTC) in this region, against the daily cap.
    - `limit` integer, required
    - `recipients` integer, required
    - `resets_at` string, date-time, required

## Other responses

- `401`: Missing, invalid, expired or revoked credentials.
- `403`: Insufficient scope, IP not allowed, workspace suspended or scheduled for deletion, or email not verified.
- `429`: Rate limited (`Retry-After`).
- `503`: Region degraded (`Retry-After`).

---

[API](https://skmtc.dev/dynamicdocumentapi/apis/dynamic-document-api.md) · [All operations](https://skmtc.dev/dynamicdocumentapi/apis/dynamic-document-api/llms.txt) · [OpenAPI document](https://skmtc.dev/dynamicdocumentapi/apis/dynamic-document-api/revisions/0f14bc0000f4?raw)