---
title: "GET /domains/{id}/deliverability"
method: GET
path: "/domains/{id}/deliverability"
---

# GET /domains/{id}/deliverability

`GET /domains/{id}/deliverability`

## Request

- Base URL: `https://api.useanima.sh/v1`
- URL: `https://api.useanima.sh/v1/domains/{id}/deliverability`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `id` string, required: Unique domain identifier

## Response `200`

OK

- object: Email deliverability statistics for a domain
  - `domain` string, required: Domain these statistics apply to
  - `sent` integer, required: Total number of emails sent
  - `delivered` integer, required: Number of emails successfully delivered
  - `bounced` integer, required: Number of emails that bounced
  - `complained` integer, required: Number of emails marked as spam by recipients
  - `bounceRate` number, required: Bounce rate as a decimal (e.g. 0.02 for 2%)
  - `complaintRate` number, required: Complaint rate as a decimal (e.g. 0.001 for 0.1%)
  - `isHealthy` boolean, required: Whether deliverability metrics are within acceptable thresholds
  - `dmarc` object, required: DMARC aggregate reports received for this domain, summarizing how receiving mail providers authenticated mail claiming to be from it
    - `reportCount` integer, required: Number of DMARC aggregate reports received in the window
    - `messages` integer, required: Total messages covered by those reports, as counted by the reporting providers
    - `passed` integer, required: Messages that passed DMARC — DKIM or SPF authenticated AND aligned with the From domain
    - `failed` integer, required: Messages that failed DMARC — neither DKIM nor SPF aligned. Spoofing, or a legitimate sender you have not authorized
    - `passRate` number, required: Fraction of reported messages that passed DMARC (0-1). 0 when no messages were reported
    - `quarantined` integer, required: Messages the receiving provider quarantined under your published policy
    - `rejected` integer, required: Messages the receiving provider rejected under your published policy
    - `reporters` string[], required: Providers that sent reports in the window (e.g. google.com, outlook.com)
    - `topSources` object[], required: Busiest sending sources in the window, most messages first
      - `sourceIp` string, required: IP address that sent mail claiming to be from this domain
      - `messages` integer, required: Messages seen from this source in the window
      - `passed` integer, required: Messages from this source that passed DMARC (DKIM or SPF aligned)
      - `failed` integer, required: Messages from this source that failed DMARC (neither DKIM nor SPF aligned)
    - `topFailingSources` object[], required: Sources with the most DMARC failures, most failures first — where to look for spoofing or an unauthorized sender
      - `sourceIp` string, required: IP address that sent mail claiming to be from this domain
      - `messages` integer, required: Messages seen from this source in the window
      - `passed` integer, required: Messages from this source that passed DMARC (DKIM or SPF aligned)
      - `failed` integer, required: Messages from this source that failed DMARC (neither DKIM nor SPF aligned)
    - `lastReportAt` string, date-time, nullable, required: End of the most recent reporting period, or null if no reports have been received
    - `windowDays` integer, required: Length of the reporting window these figures cover, in days

---

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