🔒

DNS Health Check

Comprehensive DNS health audit with scoring and letter grade.

GET /v1/health

curl "https://dns.toolkitapi.io/v1/health?domain=toolkitapi.io"

import httpx

resp = httpx.get(
    "https://dns.toolkitapi.io/v1/health?domain=toolkitapi.io",
)
print(resp.json())

const resp = await fetch("https://dns.toolkitapi.io/v1/health?domain=toolkitapi.io", {
});
const data = await resp.json();
console.log(data);

# See curl example

Response 200 OK

{
  "domain": "toolkitapi.io",
  "score": 85,
  "grade": "B",
  "checks": [
    {"check": "NS Records", "status": "pass", "detail": "Found 2 nameservers on different subnets", "points": 15},
    {"check": "SOA Record", "status": "pass", "detail": "Valid SOA with reasonable TTLs", "points": 10},
    {"check": "MX Records", "status": "pass", "detail": "Found 1 MX record", "points": 10},
    {"check": "SPF Record", "status": "pass", "detail": "Valid SPF record found", "points": 15},
    {"check": "DMARC Record", "status": "warn", "detail": "DMARC policy set to none", "points": 5},
    {"check": "CAA Records", "status": "fail", "detail": "No CAA records found", "points": 0}
  ],
  "query_time_ms": 234.7
}

Try It Live

Description

Comprehensive DNS health audit with scoring and letter grade.

How to Use

1

1. Pass the domain in the `domain` parameter. 2. Check the `grade` for a quick assessment. 3. Review individual `checks` — fix "fail" items first, then "warn" items.

About This Tool

DNS Health Check runs a comprehensive audit of a domain's DNS configuration and returns a score (0-100) with a letter grade (A-F). It checks NS redundancy, SOA configuration, A/AAAA records, MX records, CAA records, SPF, and DMARC — giving you a complete picture of DNS health in one call.

Why Use This Tool

DNS audit — Get a quick health score for any domain
Pre-launch checklist — Verify DNS is properly configured before going live
Client reporting — Generate DNS health reports for clients
Continuous monitoring — Track DNS health score over time

Frequently Asked Questions

What checks are performed?

NS redundancy, SOA validity, A/AAAA records, MX records, CAA records, SPF record, and DMARC record.

What score gets an A?

90-100. This typically requires proper NS redundancy, valid SOA, MX records, CAA, SPF, and DMARC with quarantine/reject policy.

Start using DNS Health Check now

Get your free API key and make your first request in under a minute.

Get Free API Key View Docs