---
title: "Email deliverability stats"
method: GET
path: "/email/stats"
tags: ["Emails"]
---

# Email deliverability stats

`GET /email/stats`

## Request

- Base URL: `https://www.unitpost.com/api/v1`
- URL: `https://www.unitpost.com/api/v1/email/stats`
- Auth: HTTP bearer

Retrieve aggregate deliverability and engagement metrics for your workspace over a rolling window. You get totals (sent, delivered, opened, clicked, bounced, complained, failed) alongside the rates that matter — delivery, open, click, bounce, and complaint. Open and click rates count only emails where that tracking was enabled, so turning tracking off for transactional mail won't skew them. Control the window with the `days` parameter (1–365, default 30). For the individual emails behind these numbers, see [List sent emails](#get-email). Requires the `emails:read` capability.

## Query parameters

- `days` integer

## Response `200`

The stats for the window.

- EmailStats
  - `windowDays` integer, required: The rolling window, in days.
  - `clampedToRetentionDays` integer, nullable: Non-null when the requested window exceeded the plan's log retention and was clamped to this many days (data past the retention horizon is purged).
  - `totals` object, required
    - `sent` integer, required
    - `delivered` integer, required
    - `opened` integer, required
    - `clicked` integer, required
    - `bounced` integer, required
    - `complained` integer, required
    - `failed` integer, required
  - `rates` object, required: Percentages (one decimal). delivery/bounce/complaint are vs sent; open/click are vs delivered.
    - `delivery` number, required
    - `open` number, required
    - `click` number, required
    - `bounce` number, required
    - `complaint` number, required

## Other responses

- `401`: Missing or invalid API key.
- `403`: Insufficient scope.
- `422`: Invalid `days` parameter.

---

[API](https://skmtc.dev/unitpost/apis/unitpost-api.md) · [All operations](https://skmtc.dev/unitpost/apis/unitpost-api/llms.txt) · [OpenAPI document](https://skmtc.dev/unitpost/apis/unitpost-api/revisions/86ff7c890967?raw)