---
title: "Get deliverability insights for recent sends"
method: GET
path: "/deliverability"
tags: ["Deliverability"]
---

# Get deliverability insights for recent sends

`GET /deliverability`

## Request

- Base URL: `https://api.supersendtx.com`
- URL: `https://api.supersendtx.com/deliverability`
- Auth: HTTP bearer

## Query parameters

- `window` '7d' | '30d'

## Response `200`

Deliverability insights

- DeliverabilityInsightsResponse
  - `window` '7d' | '30d', required
  - `window_start` string, date-time, required
  - `generated_at` string, date-time, required
  - `summary` DeliverabilityBucket, required
    - `total_emails` integer, required
    - `attempted` integer, required
    - `sent` integer, required
    - `delivered` integer, required
    - `bounced` integer, required
    - `complained` integer, required
    - `failed` integer, required
    - `suppressed` integer, required
    - `scheduled` integer, required
    - `opened` integer, required
    - `clicked` integer, required
    - `bounce_rate` number, required
    - `complaint_rate` number, required
    - `delivery_rate` number, required
    - `open_rate` number, required
    - `click_rate` number, required
  - `by_domain` DeliverabilityDomainInsight[], required
    - `total_emails` integer, required
    - `attempted` integer, required
    - `sent` integer, required
    - `delivered` integer, required
    - `bounced` integer, required
    - `complained` integer, required
    - `failed` integer, required
    - `suppressed` integer, required
    - `scheduled` integer, required
    - `opened` integer, required
    - `clicked` integer, required
    - `bounce_rate` number, required
    - `complaint_rate` number, required
    - `delivery_rate` number, required
    - `open_rate` number, required
    - `click_rate` number, required
    - `domain` string, required
    - `mail_server_relay` DeliverabilityMailServerRelay: Optional relay-side delivery counts from the transactional mail server when relay metrics are available.
      - `window_days` integer, required: Lookback window in days for relay-side counts.
      - `total_messages` integer, required
      - `sent` integer, required
      - `bounced` integer, required
      - `failed` integer, required
      - `delayed` integer, required
  - `top_bounce_reasons` object[], required
    - `reason` string, required
    - `count` integer, required
  - `notes` string[], required

## Other responses

- `400`: `window` is not `7d` or `30d`
- `401`: Unauthorized

---

[API](https://skmtc.dev/ranla/apis/supersend-tx-api.md) · [All operations](https://skmtc.dev/ranla/apis/supersend-tx-api/llms.txt) · [OpenAPI document](https://skmtc.dev/ranla/apis/supersend-tx-api/revisions/e3e782652f50?raw)