---
title: "Aggregate delivery outcomes for a mailbox's outbound mail"
method: GET
path: "/v1/emails/delivery-stats"
tags: ["Messages"]
---

# Aggregate delivery outcomes for a mailbox's outbound mail

`GET /v1/emails/delivery-stats`

## Request

- Base URL: `https://api.usemektup.com`
- URL: `https://api.usemektup.com/v1/emails/delivery-stats`
- Auth: HTTP bearer

Counts of sent/deferred/bounced/unknown over a time window, sourced from Mektup's own Postfix delivery log rather than a third-party tracking service.

## Query parameters

- `mailbox` string, required
- `days` integer

## Response `200`

OK

- object
  - `mailbox` string
  - `days` integer
  - `total` integer
  - `sent` integer
  - `deferred` integer
  - `bounced` integer
  - `unknown` integer

## Other responses

- `400`: Invalid request

---

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