Docs menu

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

Run it in the browser

Query parameters

Query parameters
NameTypeDescription
domain (required)stringA domain or URL; the zone it belongs to is checked.
freshbooleanSkip the cache and ask the source again; costs the same.

Response

Response fields
NameTypeDescription
tool (required)string
target (required)string
status (required)"ok" | "partial" | "error"
fetched_atstring
cachedboolean
credits_usedintegerCredits 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
scoreinteger or null
findingsarray of object
credits_remaining (required)integerYour balance after this call. It can be below zero after a refund; free tools still work then
data (required)objectThis tool's result
data.name (required)stringThe name asked about, in ASCII
data.unicode (required)string
data.zone (required)stringThe 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 nullA DS record for this zone exists at its parent
data.chain.secure (required)boolean or nullThe 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.bitsinteger or null
data.dnskeys.revoked (required)boolean
data.dnskeys.servers (required)array of stringAddresses 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_iterationsinteger or null
data.denial.nsec3_salt_lengthinteger or null
data.denial.nsec3_opt_outboolean or null
data.parent_ns (required)array of string
data.parent_ns_ttlinteger 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)objectSerial number -> addresses serving it
data.ipv6_checked (required)boolean
data.min_ttlinteger 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
curl "https://api.dnssuper.com/v1/dnssec?domain=example.com" \
  -H "Authorization: Bearer $DNSSUPER_API_KEY"

Python

Python (httpx)
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

TypeScript (fetch)
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
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

MCP tool call
{
  "tool": "check_dnssec",
  "arguments": {
    "domain": "example.com"
  }
}
Compact MCP output
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