---
title: "Domain summary"
method: GET
path: "/v1/domains/{domain}/summary"
tags: ["Overview"]
---

# Domain summary

`GET /v1/domains/{domain}/summary`

## Request

- Base URL: `https://data.inboxpro.io`
- URL: `https://data.inboxpro.io/v1/domains/{domain}/summary`
- Auth: HTTP bearer

Totals and rates for everything sent from one domain over a period: deliveries, bounces, opens, clicks, and unsubscribes.

## Path parameters

- `domain` string, required

## Query parameters

- `from` string, date
- `to` string, date
- `exclude_bots` boolean

## Response `200`

Default Response

- object
  - `domain` string, required
  - `period` object, required: The days these numbers cover (UTC, both inclusive).
    - `from` string, date, required
    - `to` string, date, required
  - `bots_excluded` boolean, required: Whether automated opens and clicks were left out.
  - `data_as_of` string, date-time, required: Numbers include activity up to this moment. Recent hours may still change slightly.
  - `first_sent_at` string, date-time, nullable: First email sent in the period.
  - `last_sent_at` string, date-time, nullable: Last email sent in the period.
  - `totals` object, required
    - `sent` integer, required: Emails handed to recipients' mail servers: delivered plus bounced. Rejections are not included.
    - `delivered` integer, required: Emails accepted by the recipient's mail server.
    - `bounces` integer, required: Emails the recipient's mail server refused, for example because the address does not exist.
    - `rejections` integer, required: Emails our servers refused to accept from your sending system, for example because they failed a sending policy check. These were never sent.
    - `opens` integer, required: Recipients who opened the email at least once.
    - `clicks` integer, required: Recipients who clicked at least one link.
    - `unsubscribes` integer, required: Recipients who unsubscribed.
  - `rates` object, required
    - `delivery_rate` number, nullable, required: Delivered ÷ sent. Percentage, 0–100, rounded to 2 decimals. Null when there is nothing to divide by.
    - `bounce_rate` number, nullable, required: Bounces ÷ sent. Percentage, 0–100, rounded to 2 decimals. Null when there is nothing to divide by.
    - `open_rate` number, nullable, required: Opens ÷ delivered. Percentage, 0–100, rounded to 2 decimals. Null when there is nothing to divide by.
    - `click_rate` number, nullable, required: Clicks ÷ delivered. Percentage, 0–100, rounded to 2 decimals. Null when there is nothing to divide by.
    - `click_to_open_rate` number, nullable, required: Clicks ÷ opens. Percentage, 0–100, rounded to 2 decimals. Null when there is nothing to divide by.
    - `unsubscribe_rate` number, nullable, required: Unsubscribes ÷ delivered. Percentage, 0–100, rounded to 2 decimals. Null when there is nothing to divide by.

## Other responses

- `400`: A parameter is missing or invalid.
- `401`: The API key is missing, invalid, or revoked.
- `404`: The domain is not one of your sending domains.
- `429`: Too many requests in a short time, or the daily request quota is used up.
- `503`: Stats are briefly unavailable. Retry after a short wait.

---

[API](https://skmtc.dev/inboxpro/apis/inboxpro-stats-api.md) - [All operations](https://skmtc.dev/inboxpro/apis/inboxpro-stats-api/llms.txt) - [OpenAPI document](https://skmtc.dev/inboxpro/apis/inboxpro-stats-api/revisions/e0a4b5c280ce?raw)