---
title: "Get domain health summary"
method: GET
path: "/email_domains/{id}/health"
tags: ["Email Domains"]
---

# Get domain health summary

`GET /email_domains/{id}/health`

Returns a summary of domain health including verification status and usability.

## Path parameters

- `id` string, uuid, required

## Response `200`

Domain health summary

- EmailDomainHealthResponse
  - `data` EmailDomainHealth, required
    - `id` string, uuid, required — Unique identifier for the email domain
    - `record_type` 'email_domain_health', required — Record type discriminator
    - `status` 'pending' | 'verifying' | 'verified' | 'failed' | 'degraded' | 'suspended', required — Current domain status
    - `usable_for_sending` boolean, required — Whether the domain is usable for sending email
    - `usable_for_inbound` boolean, required — Whether the domain is usable for receiving inbound email
    - `verification` EmailDomainVerification, required
      - `ownership` 'pending' | 'verified' | 'not_required', required
      - `spf` 'missing_optional' | 'verified' | 'failed' | 'not_required', required
      - `dkim` 'pending' | 'verified' | 'failed', required
      - `dmarc` 'missing_optional' | 'verified' | 'failed', required
      - `mx` 'not_required' | 'pending' | 'verified' | 'failed', required
    - `checked_at` string, date-time, required — Timestamp of the last health check

## Other responses

- `404` — Resource not found
- `500` — Internal server error

## Changes

> 92 revisions in range; 1 not diffed.

- **2026-09-23** `16bfa298dc71` — 2 warning
  - added the new `40901` enum value to the `errors/items/code` response property for the response status `404`
  - added the new `40901` enum value to the `errors/items/code` response property for the response status `500`
- **2026-07-28** `b1bf96d8391e` — 2 warning
  - added the new `not_required` enum value to the `data/verification/ownership` response property for the response status `200`
  - added the new `not_required` enum value to the `data/verification/spf` response property for the response status `200`
- **2026-07-07** `6ef0ae248bf7` — 1 info
  - endpoint added
- **2026-07-02** `224ed0d8a5c3` — 1 breaking
  - api path removed without deprecation

[Change history](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/changes/email_domains/:id/health/get.md)

---

[API](https://skmtc.dev/team-telnyx/apis/telnyx-api-2.md) · [All operations](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/llms.txt) · [OpenAPI document](https://skmtc.dev/team-telnyx/apis/telnyx-api-2/revisions/d8b8159753ee?raw)