Skip to content
regfish Docs

Full DNS health check

GET /api/v1/check/{domain}

Runs 25+ checks (delegation, SOA, MX, SPF, DKIM, DMARC, MTA-STS, TLS-RPT, web records, CAA, DNSSEC) and returns a score with findings and copy-ready fixes.

Path parameters

Section titled “Path parameters”
Name Type Required Description
domain string yes —

Query parameters

Section titled “Query parameters”
Name Type Required Description
lang string no —

Responses

Section titled “Responses”
Status Type Description
200 DomainHealth Health report
400 object Error
429 object Error

Response body

Section titled “Response body”
Field Type Required Description
api string no —
domain string no —
displayDomain string no —
resolvable boolean no —
score integer no —
findings Finding[] no —
summary object no —
checkedAt string no —
locale string no (en, de)

Example

Section titled “Example”
Terminal-Fenster
curl -X GET "https://dns-doctor.com/api/v1/check/<domain>" \
  -H "Authorization: Bearer $REGFISH_API_KEY"

Build a request

Section titled “Build a request”

Fill in values — the call below updates as you type. Nothing is sent: the API does not currently allow browser requests from this domain (CORS). The API key is not stored.