---
title: "Check domain health: DNS, SSL, email, expiry"
method: GET
path: "/api/domains/{domain}/status"
tags: ["Status"]
---

# Check domain health: DNS, SSL, email, expiry

`GET /api/domains/{domain}/status`

## Request

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

Checks the health of a domain via DNS-over-HTTPS: A/AAAA/CNAME/MX/TXT/NS records, SSL certificate status, email configuration, and expiry date. Supports SSE streaming via `Accept: text/event-stream` - closing the connection cancels in-flight DNS/SSL checks server-side. Use this after connecting to verify DNS propagation.

## Path parameters

- `domain` string, required

## Response `200`

Domain health status

- object
  - `domain` string
  - `status` string
  - `expires` string, date-time
  - `days_until_expiry` integer
  - `dns` object
    - `propagated` boolean
    - `a` string[]
    - `aaaa` string[]
    - `cname` string[]
    - `mx` string[]
    - `txt` string[]
    - `ns` string[]
    - `registrar_records` DnsRecord[]
      - `type` 'A' | 'AAAA' | 'CNAME' | 'MX' | 'TXT' | 'NS' | 'SRV' | 'CAA' | 'TLSA', required: DNS record type. TLSA publishes a DANE record; its value is the rdata 'usage selector matching-type hex-data'.
      - `name` string, required: Record name (@ for root, or subdomain, e.g. _443._tcp for TLSA)
      - `value` string, required: Record value (IP address, hostname, or TLSA rdata like '3 1 1 abc123...')
      - `ttl` integer, required: Time to live in seconds
      - `priority` integer: Priority value (required for MX records)
      - `required` boolean: False when the zone Domani manages for the domain cannot hold the record (a TXT longer than the registrar accepts); such a record is shown but not needed for mail to work. Absent on plain zone records.
  - `ssl` object
    - `active` boolean
  - `email` object
    - `configured` boolean
    - `mx` 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)