DNSSEC and nameservers
Check a domain's DNSSEC chain of trust and every nameserver, straight from the registry and the servers themselves.
GET /v1/dnssec
- Price
- Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free.
- Cache
- Answers are cached for up to 5 minutes; send fresh=true to ask the source again.
- MCP tool
- check_dnssec
Query parameters
| Name | Type | Description |
|---|---|---|
| domain (required) | string | A domain or URL; the zone it belongs to is checked. |
| fresh | boolean | Skip the cache and ask the source again; costs the same. |
Response
| Name | Type | Description |
|---|---|---|
| tool (required) | string | |
| target (required) | string | |
| status (required) | "ok" | "partial" | "error" | |
| fetched_at | string | |
| cached | boolean | |
| credits_used | integer | Credits this call took from your balance. 0 for free tools, for a replay of an earlier call, and for a free check run on the website without signing in |
| summary (required) | string | |
| score | integer or null | |
| findings | array of object | |
| credits_remaining (required) | integer | Your balance after this call. It can be below zero after a refund; free tools still work then |
| data (required) | object | This tool's result |
| data.name (required) | string | The name asked about, in ASCII |
| data.unicode (required) | string | |
| data.zone (required) | string | The zone checked: the name itself or the zone it lives in |
| data.parent (required) | string | |
| data.dnssec (required) | "secure" | "insecure" | "bogus" | "indeterminate" | |
| data.extended_errors (required) | array of object | |
| data.extended_errors.code (required) | integer | |
| data.extended_errors.text (required) | string | |
| data.chain (required) | array of object | |
| data.chain.zone (required) | string | |
| data.chain.signed (required) | boolean or null | A DS record for this zone exists at its parent |
| data.chain.secure (required) | boolean or null | The resolver validated that DS answer |
| data.ds (required) | array of object | |
| data.ds.key_tag (required) | integer | |
| data.ds.algorithm (required) | integer | |
| data.ds.algorithm_name (required) | string | |
| data.ds.digest_type (required) | integer | |
| data.ds.matches_key (required) | boolean | |
| data.dnskeys (required) | array of object | |
| data.dnskeys.key_tag (required) | integer | |
| data.dnskeys.role (required) | "ksk" | "zsk" | "csk" | |
| data.dnskeys.algorithm (required) | integer | |
| data.dnskeys.algorithm_name (required) | string | |
| data.dnskeys.bits | integer or null | |
| data.dnskeys.revoked (required) | boolean | |
| data.dnskeys.servers (required) | array of string | Addresses that served this key |
| data.signatures (required) | array of object | |
| data.signatures.covers (required) | string | |
| data.signatures.key_tag (required) | integer | |
| data.signatures.expiration (required) | string | |
| data.signatures.expires_in_days (required) | integer | |
| data.signatures.state (required) | "valid" | "invalid" | "expired" | "not_yet_valid" | "no_key" | "unsupported_algorithm" | |
| data.signatures.servers (required) | array of string | |
| data.denial (required) | object | |
| data.denial.kind (required) | "nsec" | "nsec3" | "compact" | "none" | "unknown" | |
| data.denial.nsec3_iterations | integer or null | |
| data.denial.nsec3_salt_length | integer or null | |
| data.denial.nsec3_opt_out | boolean or null | |
| data.parent_ns (required) | array of string | |
| data.parent_ns_ttl | integer or null | |
| data.child_ns (required) | array of string | |
| data.nameservers (required) | array of object | |
| data.nameservers.name (required) | string | |
| data.nameservers.in_parent (required) | boolean | |
| data.nameservers.in_child (required) | boolean | |
| data.nameservers.glue (required) | array of string | |
| data.nameservers.addresses (required) | array of string | |
| data.nameservers.status (required) | "ok" | "lame" | "unreachable" | "no_address" | "untested" | |
| data.nameservers.servers (required) | array of object | |
| data.serials (required) | object | Serial number -> addresses serving it |
| data.ipv6_checked (required) | boolean | |
| data.min_ttl | integer or null |
Errors
- 400 Invalid domain, URL or parameter, a TLD this tool can't check, or an X-Request-Id already used for another call (`invalid_domain`, `invalid_url`, `invalid_request`, `unsupported_tld`)
- 401 Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)
- 402 Balance below the call's price (`insufficient_credits`)
- 403 Account suspended, the key's creator is over the plan's seats, or an anonymous check without a valid proof-of-work or for a tool that needs an account, or bulk checks before a first purchase (`account_suspended`, `plan_limit`, `challenge_required`, `sign_in_required`, `bulk_locked`)
- 429 Too many requests, today's free checks are used up, or too many website scans at once; wait for the number of seconds in the Retry-After header (`rate_limited`, `free_limit_reached`, `too_many_jobs`). Not charged
- 500 Unexpected error (`internal_error`)
- 502 Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to
Example
curl
curl "https://api.dnssuper.com/v1/dnssec?domain=example.com" \
-H "Authorization: Bearer $DNSSUPER_API_KEY"Python
import os
import httpx
client = httpx.Client(
base_url="https://api.dnssuper.com",
headers={"Authorization": f"Bearer {os.environ['DNSSUPER_API_KEY']}"},
timeout=60,
)
response = client.get("/v1/dnssec", params={
"domain": "example.com",
})
response.raise_for_status()
result = response.json()
print(result["summary"], result["credits_used"])TypeScript
const response = await fetch(`https://api.dnssuper.com/v1/dnssec?${new URLSearchParams({"domain":"example.com"})}`, {
headers: { Authorization: `Bearer ${process.env.DNSSUPER_API_KEY}` },
});
if (!response.ok) throw new Error((await response.json()).error.message);
const result = await response.json();
console.log(result.summary, result.credits_used);Example response
{
"tool": "dnssec-checker",
"target": "example.com",
"status": "ok",
"fetched_at": "2026-11-14T10:00:00Z",
"cached": false,
"credits_used": 2,
"summary": "example.com is DNSSEC-signed and validates, and 2 of 2 nameservers answer correctly.",
"findings": [
{
"id": "dnssec.nsec3",
"severity": "info",
"title": "Your zone uses NSEC3",
"detail": "Answers for missing names carry NSEC3 records.",
"fix": "Nothing to do."
},
{
"id": "dnssec.secure",
"severity": "pass",
"title": "DNSSEC is set up correctly",
"detail": "The chain of trust from the root down to example.com validates.",
"fix": "Nothing to do."
},
{
"id": "ns.consistent",
"severity": "pass",
"title": "Your nameservers all answer and agree",
"detail": "2 nameservers answered authoritatively with the same serial.",
"fix": "Nothing to do."
}
],
"data": {
"name": "example.com",
"unicode": "example.com",
"zone": "example.com",
"parent": "com",
"parent_ns": [
"ns1.example.com",
"ns2.example.com"
],
"parent_ns_ttl": 172800,
"child_ns": [
"ns1.example.com",
"ns2.example.com"
],
"chain": [
{
"zone": "com",
"signed": true,
"secure": true
},
{
"zone": "example.com",
"signed": true,
"secure": true
}
],
"dnssec": "secure",
"extended_errors": [],
"ds": [
{
"key_tag": 65437,
"algorithm": 13,
"algorithm_name": "ECDSAP256SHA256",
"digest_type": 2,
"matches_key": true
}
],
"dnskeys": [
{
"key_tag": 65437,
"role": "csk",
"algorithm": 13,
"algorithm_name": "ECDSAP256SHA256",
"bits": 256,
"revoked": false,
"servers": [
"192.0.2.1",
"198.51.100.2"
]
}
],
"signatures": [
{
"covers": "DNSKEY",
"key_tag": 65437,
"expiration": "2026-11-28T10:00:00Z",
"expires_in_days": 14,
"state": "valid",
"servers": [
"192.0.2.1",
"198.51.100.2"
]
},
{
"covers": "SOA",
"key_tag": 65437,
"expiration": "2026-11-28T10:00:00Z",
"expires_in_days": 14,
"state": "valid",
"servers": [
"192.0.2.1",
"198.51.100.2"
]
}
],
"denial": {
"kind": "nsec3",
"nsec3_iterations": 0,
"nsec3_salt_length": 0,
"nsec3_opt_out": false
},
"nameservers": [
{
"name": "ns1.example.com",
"in_parent": true,
"in_child": true,
"glue": [
"192.0.2.1"
],
"addresses": [
"192.0.2.1"
],
"status": "ok",
"servers": [
{
"address": "192.0.2.1",
"family": "ipv4",
"udp": true,
"tcp": true,
"authoritative": true,
"serial": 2026111401,
"elapsed_ms": 12,
"open_resolver": false,
"dnskey_tags": [
65437
]
}
]
},
{
"name": "ns2.example.com",
"in_parent": true,
"in_child": true,
"glue": [
"198.51.100.2"
],
"addresses": [
"198.51.100.2"
],
"status": "ok",
"servers": [
{
"address": "198.51.100.2",
"family": "ipv4",
"udp": true,
"tcp": true,
"authoritative": true,
"serial": 2026111401,
"elapsed_ms": 12,
"open_resolver": false,
"dnskey_tags": [
65437
]
}
]
}
],
"serials": {
"2026111401": [
"192.0.2.1",
"198.51.100.2"
]
},
"ipv6_checked": false,
"min_ttl": 3600
},
"credits_remaining": 498
}MCP
{
"tool": "check_dnssec",
"arguments": {
"domain": "example.com"
}
}example.com is DNSSEC-signed and validates, and 2 of 2 nameservers answer correctly.
DNSSEC: secure (zone example.com, parent com)
DS: key 65437, algorithm 13 (ECDSAP256SHA256), digest type 2, matches a served key
Keys: 65437 csk ECDSAP256SHA256 256 bits
Soonest signature expiry: 2026-11-28 (in 14 days)
ns1.example.com: ok, serial 2026111401, TCP yes
ns2.example.com: ok, serial 2026111401, TCP yes
- info: Your zone uses NSEC3
2 checks passed
Credits: 2 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC