---
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.groundmail.dev`
- URL: `https://api.groundmail.dev/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
  - `by_stream_24h` object[]: Sent, bounced and complained per mail stream over the last 24 hours (live counts), for streams with activity. Each stream sends from its own IPs.
    - `stream` 'transactional' | 'product' | 'newsletter', required: The mail stream an email went out on, from its `category`. Each stream sends from its own IPs. `newsletter` is for approved accounts only.
    - `sent` integer, required
    - `bounced` integer, required
    - `complained` integer, required
    - `bounce_rate` number, required
    - `complaint_rate` number, required

## Other responses

- `401`: Unauthorized

---

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