---
title: "Get owner-scoped email deliverability health"
method: GET
path: "/api/domains/{domain}/email/deliverability"
tags: ["Email"]
---

# Get owner-scoped email deliverability health

`GET /api/domains/{domain}/email/deliverability`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/domains/{domain}/email/deliverability`
- Auth: HTTP bearer

Separates deterministic authentication readiness, 30-day recipient-weighted delivery outcomes, account safety state, and measured provider placement. The readiness score is not an Inbox probability, and unmeasured placement is returned as not_tested.

## Path parameters

- `domain` string, required

## Response `200`

Domain email health report

- object
  - `domain` string, required
  - `status` 'healthy' | 'limited_data' | 'needs_attention' | 'at_risk' | 'paused', required
  - `confidence` 'none' | 'limited' | 'sufficient', required
  - `checked_at` string, date-time, required
  - `window_days` integer
  - `readiness` object, required: Deterministic DNS configuration readiness. Score is not an Inbox probability.
    - `score` integer
    - `configured` integer
    - `total` integer
    - `provider` string, nullable
    - `checks` object[]
      - `id` string
      - `label` string
      - `configured` boolean
  - `sending_health` object, required
    - `recipients` object
    - `rates` object
      - `bounce` number
      - `complaint` number
    - `paused` boolean
    - `pause_reason` string, nullable
    - `account_suppressions` integer
  - `placement` object, required
    - `available` boolean
    - `last_checked_at` string, date-time, nullable
    - `providers` object[]
      - `provider` 'gmail' | 'outlook' | 'yahoo'
      - `status` 'inbox' | 'spam' | 'missing' | 'error' | 'not_tested'
    - `note` string
  - `actions` object[], required
    - `id` string
    - `severity` 'info' | 'warning' | 'critical'
    - `title` string
    - `detail` string
  - `caveats` string[]

## Other responses

- `401`: Missing or invalid API key
- `404`: Domain not found
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)