---
title: "Deliverability report"
method: GET
path: "/v1/deliverability"
tags: ["Usage"]
---

# Deliverability report

`GET /v1/deliverability`

## Request

- Base URL: `https://api.deadsimple.email`
- URL: `https://api.deadsimple.email/v1/deliverability`
- Auth: HTTP bearer

Aggregated delivery outcomes for outbound mail over a time window — delivery, bounce, and complaint rates for the whole account/workspace, broken down per inbox and per sending domain, plus a hard/soft bounce breakdown and suppressed-address count. See exactly what's landing without dedicated IPs or infra to manage.

## Query parameters

- `days` integer
- `inbox_id` string
- `domain` string

## Headers

- `X-Workspace-Id` string, uuid

## Response `200`

Deliverability aggregates for the window.

- object
  - `period` object
    - `days` integer
    - `since` string, date-time
    - `until` string, date-time
  - `totals` object: Status counts plus total, delivery_rate, bounce_rate, complaint_rate.
  - `bounce_breakdown` object
    - `hard` integer
    - `soft` integer
    - `by_subtype` object
  - `by_inbox` object[]
  - `by_domain` object[]
  - `suppressed_addresses` integer

---

[API](https://skmtc.dev/deadsimple/apis/dead-simple-email-api.md) · [All operations](https://skmtc.dev/deadsimple/apis/dead-simple-email-api/llms.txt) · [OpenAPI document](https://skmtc.dev/deadsimple/apis/dead-simple-email-api/revisions/c697881be131?raw)