{
  "openapi": "3.1.0",
  "info": {
    "title": "is it DNS? API",
    "version": "2026-10-06",
    "summary": "Is it DNS? When a site or domain isn't working, one call audits it: whether the name resolves and why, with a receipt for every reading. Free, no key.",
    "description": "free · no key · no sign-in · timestamped, vantage named · 100/min per address · MCP: https://isitdns.net/mcp. Every example is a live answer, trimmed. One route serves two formats and negotiates between them: GET /api/query returns JSON, or the dig-shaped text when the Accept header asks for text/plain, whoever is asking. POST /api/query returns the same text only when the request says Accept: text/plain; with no Accept stated it returns JSON, whoever is asking. Every other /api/ route returns JSON and ignores Accept. Text form: GET /, /check/<domain>, /dig/<name>[/<type>][/<resolver>]. / answers text to a curl user agent or Accept: text/plain, and the page otherwise, application/json included. Of these three paths, /check/<domain> and /dig/<name>... go by Accept alone: listing text/html, a 302 to the page (/#check?d=<domain>, or the /dig page with the same name, type and resolver); listing application/json, the JSON of POST /api/check or GET /api/query for the same question; anything else, the text. ANSI colour only for a curl, wget or HTTPie user agent. Where a route does negotiate, Accept decides it when stated; on GET / and GET /api/query the user agent is the fallback when none is stated, and POST /api/query never reads it.",
    "contact": {
      "url": "https://isitdns.net/agents"
    }
  },
  "servers": [
    {
      "url": "https://isitdns.net"
    }
  ],
  "x-mcp": {
    "endpoint": "https://isitdns.net/mcp",
    "transport": "streamable-http",
    "tools": [
      "check_domain",
      "dig",
      "trace",
      "dnssec_chain",
      "sweep_domain",
      "registration"
    ],
    "toolDescriptions": {
      "check_domain": "Check a domain that is not working: whether the name resolves in public DNS, then the eleven-check audit of its zone, each row ok, warn, fail or skipped with why. DNS only, not HTTP or TLS, and not for one record: dig. Measured from the isitdns edge and its probes, never the caller's network. from moves the recursion, TTL and UDP truncation rows to that region's probe.",
      "dig": "Dig one name and type at one board resolver, or at Cloudflare, Google, Quad9 and AdGuard side by side (resolver all): records, flags, rcode, EDE, latency. Not for a whole domain: check_domain. Asked over DoH from the isitdns edge. from moves the question to that region's probe as Do53 over UDP, and follow: true adds the CNAME chain as separate reads with DNSSEC off. A resolver given as an address must be on the board.",
      "trace": "Trace a delegation from the root to the authority, like dig +trace: each referral and its glue, the one server that answered at each zone cut and any dial that failed, the final answer and its TTLs. Not for every server of a zone: sweep_domain. Each hop is asked with RD=0 over TCP from the isitdns edge or a probe, named on the hop. Give the full host name: the walk ends at the zone that answers for it, and type (default A) is what it asks there.",
      "dnssec_chain": "Walk the DNSSEC chain from the root to one answer: DS and DNSKEY at each signed zone cut, key tags, signers, signature windows, the first link that breaks or goes insecure, and whether the zone where it goes insecure is itself signed (an island of security). Not for one signed record: dig. Read through Cloudflare's resolver over DoH with CD=1 from the isitdns edge, and a key set a break would rest on again through Google's. Signature bytes are not verified, so a clean walk does not prove the answer validates. type (default A) is the record checked at the end, not OPT, RRSIG or a meta type such as ANY, and anchor (a DS or DNSKEY record, with anchor_zone) starts the walk at that zone instead of the root.",
      "sweep_domain": "Sweep a zone's nameservers: the same names and types asked at a sample of its authoritative addresses, reporting disagreements, lame or silent servers, serial and TTL differences, the CAA in effect, and each _acme-challenge TXT or CNAME. Not for a public resolver's answer: dig. Asked with RD=0 over TCP from the isitdns edge or a probe, named on each answer. Every question not asked is listed with why, and an answer past 22,000 bytes is trimmed with counts, the whole sweep at its api: URL. names are labels under domain (@ for domain itself), 16 at most, and types 8 at most.",
      "registration": "Read a domain's registration from its registry's RDAP server: each status with what it means for resolution, the registration, expiry and change dates, the nameservers, whether the delegation is signed. Not for what DNS answers: check_domain. Read over HTTPS from the isitdns edge through IANA's RDAP bootstrap, and no contacts are returned. A hostname is read at the name, then each parent down to the registered domain, and each HTTP read is listed with its URL, status and time."
    },
    "prompts": [
      "is_it_dns",
      "after_change_check",
      "mail_check",
      "dnssec_servfail"
    ]
  },
  "paths": {
    "/api/query": {
      "get": {
        "operationId": "dig",
        "summary": "Ask a public resolver, or any public address, for a record",
        "description": "The dig tool. JSON by default; with a curl user agent or Accept: text/plain the answer comes back in the shape dig prints.",
        "parameters": [
          {
            "name": "name",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            },
            "example": "example.com"
          },
          {
            "name": "type",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "A"
            },
            "description": "Record type, e.g. A, MX, TXT, DS, HTTPS, or TYPE<n>"
          },
          {
            "name": "resolver",
            "in": "query",
            "schema": {
              "type": "string",
              "default": "cloudflare"
            },
            "description": "A board resolver id (cloudflare, google, quad9, opendns, adguard, ...), its address or host name (8.8.8.8, dns.google), \"all\" for cloudflare, google, quad9 and adguard side by side, or any public IP address. With \"all\", a row the requested transport cannot reach is asked over one it can (tcp53, dot, doh), and transportUsed names it; over udp53 such a row is not asked."
          },
          {
            "name": "ip",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "Up to 6 public addresses, comma separated, asked in place of resolver."
          },
          {
            "name": "transport",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "doh",
                "dot",
                "tcp53",
                "udp53"
              ],
              "default": "doh"
            },
            "description": "doh, dot and tcp53 are asked from the edge; udp53 from a probe, theoracle (Phoenix) unless from names a region"
          },
          {
            "name": "dnssec",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": true
            },
            "description": "Set DO and read AD; dnssec=0 turns it off"
          },
          {
            "name": "cd",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": false
            },
            "description": "Set CD (checking disabled)"
          },
          {
            "name": "ecs",
            "in": "query",
            "schema": {
              "type": "string"
            },
            "description": "EDNS Client Subnet, CIDR, e.g. 192.0.2.0/24"
          },
          {
            "name": "norec",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": false
            },
            "description": "Clear RD, like dig +norec"
          },
          {
            "name": "nsid",
            "in": "query",
            "schema": {
              "type": "boolean",
              "default": false
            }
          },
          {
            "name": "family",
            "in": "query",
            "schema": {
              "type": "string",
              "enum": [
                "v4",
                "v6",
                "both"
              ],
              "default": "v4"
            },
            "description": "Address family dialled over dot, tcp53 and udp53 (both: a row per family the resolver has an address in); over DoH the family is not chosen"
          },
          {
            "name": "from",
            "in": "query",
            "description": "Ask over Do53/UDP from the probe in this region (no other transport): north-america is theoracle (Phoenix), europe is thewizard (Amsterdam)",
            "schema": { "type": "string", "enum": ["north-america", "europe"] }
          },
          { "name": "follow", "in": "query", "description": "Also walk the CNAME chain from the name, hop by hop, to its addresses: each hop asked for CNAME at Cloudflare's DoH from the edge. The chain is the response's follow, beside results; the text form prints it after the dig. Nothing is walked for a refused name.", "schema": { "type": "boolean", "default": false } }
        ],
        "responses": {
          "200": {
            "description": "The answer from each resolver asked",
            "content": {
              "application/json": {
                "example": {"askedAt":"2026-10-08T12:00:33.183Z","query":{"name":"example.com","type":"A","dnssec":true,"cd":false,"ecs":null,"transport":"doh","ipFamily":"v4","noRecurse":false,"nsid":false},"results":[{"resolver":{"id":"cloudflare","name":"Cloudflare","ips":["1.1.1.1","1.0.0.1"]},"latencyMs":2,"response":{"id":13628,"qr":true,"opcode":0,"aa":false,"tc":false,"rd":true,"ra":true,"ad":true,"cd":false,"rcode":0,"rcodeName":"NOERROR","qdCount":1,"anCount":3,"nsCount":0,"arCount":1,"question":{"name":"example.com.","type":1,"typeName":"A"},"answer":[{"name":"example.com.","type":1,"typeName":"A","class":1,"ttl":268,"data":"104.20.23.154"}],"authority":[],"additional":[]},"ipUsed":"cloudflare-dns.com (auto)","vantage":{"seat":"edge","label":"the isitdns edge","place":"ATL"},"size":179,"at":"2026-10-08T12:00:33.183Z","transportUsed":"doh"}],"omitted":[]},
                "schema": {
                  "$ref": "#/components/schemas/QueryResult"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string"
                }
              }
            }
          },
          "400": {
            "description": "The name, type, transport or an address did not validate",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          },
          "429": {
            "description": "Rate limited"
          }
        }
      },
      "post": {
        "operationId": "digPost",
        "summary": "The same query as a JSON body",
        "description": "The parameters of GET /api/query as a JSON body (QueryBody). The answer is JSON unless this request states Accept: text/plain, then the dig-shaped text; the user agent is not read.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {"name":"example.com","type":"MX","resolver":"google"},
              "schema": {
                "$ref": "#/components/schemas/QueryBody"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "See GET. JSON, or the same dig-shaped text when this request states Accept: text/plain.",
            "content": {
              "application/json": {
                "example": {"askedAt":"2026-10-08T12:00:33.355Z","query":{"name":"example.com","type":"MX","dnssec":true,"cd":false,"ecs":null,"transport":"doh","ipFamily":"v4","noRecurse":false,"nsid":false},"results":[{"resolver":{"id":"google","name":"Google","ips":["8.8.8.8","8.8.4.4"]},"latencyMs":26,"response":{"id":5074,"qr":true,"opcode":0,"aa":false,"tc":false,"rd":true,"ra":true,"ad":true,"cd":false,"rcode":0,"rcodeName":"NOERROR","qdCount":1,"anCount":2,"nsCount":0,"arCount":1,"question":{"name":"example.com.","type":15,"typeName":"MX"},"answer":[{"name":"example.com.","type":15,"typeName":"MX","class":1,"ttl":118,"data":"0 ."}],"authority":[],"additional":[]},"ipUsed":"dns.google (auto)","vantage":{"seat":"edge","label":"the isitdns edge","place":"ATL"},"size":162,"at":"2026-10-08T12:00:33.355Z","transportUsed":"doh"}],"omitted":[]},
                "schema": {
                  "$ref": "#/components/schemas/QueryResult"
                }
              },
              "text/plain": {
                "schema": {
                  "type": "string",
                  "description": "The answer in dig's output format, as GET /api/query and /dig/<name> print it. Only with Accept: text/plain; a POST with no Accept gets JSON."
                }
              }
            }
          }
        }
      }
    },
    "/api/check": {
      "get": {
        "operationId": "checkDomainGet",
        "summary": "The same audit as the POST form, from the query string",
        "description": "The eleven checks of POST /api/check, from the query string. This URL is the api: line of every MCP check_domain answer. A stored result says so: its generatedAt is the time it was read and its receipts are marked stored. HEAD is not answered.",
        "parameters": [
          { "name": "name", "in": "query", "required": true, "schema": { "type": "string" } },
          { "name": "from", "in": "query", "description": "Region of the probe for the recursion, TTL and UDP truncation rows", "schema": { "type": "string", "enum": ["north-america", "europe"] } }
        ],
        "responses": {
          "200": {
            "description": "Each check with what it found and the ids of its receipts; every transaction the audit made (receipts), the authoritative address asked (auth) and the nameservers the parent named (parentNs)",
            "content": { "application/json": { "example": {"resolves":{"state":"resolves","line":"example.com resolves: A 104.20.23.154, A 172.66.147.243 · NOERROR from 1.1.1.1 over DoH; every address in Cloudflare's published ranges","receipts":["r10","r12"],"asked":[]},"domain":"example.com","generatedAt":"2026-10-08T12:00:34.338Z","summary":{"ok":9,"warn":1,"fail":0,"skip":1,"resolves":"resolves"},"checks":[{"id":"ns-consistency","label":"Parent/child NS consistency","status":"ok","detail":"Parent and child agree on all 2 nameservers. None of the 2 nameserver names is an alias or `NXDOMAIN` (names outside the zone answered by Cloudflare 1.1.1.1 over DoH).","source":"doh","receipts":["r03","r04"]}],"receipts":[{"id":"r01","askedAt":"2026-10-08T12:00:33.591Z","source":"fresh","vantage":{"seat":"edge","place":"ATL"},"target":{"id":"198.41.0.4","name":"198.41.0.4"},"endpoint":"198.41.0.4:53","address":"198.41.0.4","addressRecorded":true,"qname":"example.com","qtype":"NS","rd":false,"do":true,"cd":false,"family":"v4","transport":"tcp53","transportRecorded":true,"outcome":"answered","remoteAddress":"198.41.0.4","latencyMs":28,"rcode":"NOERROR","flags":"qr","ad":false,"tc":false,"ede":"none received","answer":[],"authority":["com. 172800 IN NS l.gtld-servers.net.","com. 172800 IN NS j.gtld-servers.net."],"size":1171,"error":"none"}],"auth":{"address":"108.162.192.162"},"parentNs":["hera.ns.cloudflare.com","elliott.ns.cloudflare.com"]}, "schema": { "$ref": "#/components/schemas/CheckResult" } } }
          }
        }
      },
      "post": {
        "operationId": "checkDomain",
        "summary": "What eleven DNS checks found for a domain, or for the zone a hostname sits in",
        "description": "Finds the authoritative servers with a walk from the root, then runs eleven checks against them: NS consistency, open recursion, DNSSEC, TTLs, SPF, DMARC, CAA, wildcard, glue, DS against DNSKEY and UDP truncation. Each row says what it found, with the receipts it rests on; there is no score. resolves says first whether the name resolves in public DNS.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {"name":"example.org"},
              "schema": {
                "type": "object",
                "required": [
                  "name"
                ],
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "from": { "type": "string", "enum": ["north-america", "europe"], "description": "Region of the probe for the recursion, TTL and UDP truncation rows" }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Each check with what it found",
            "content": {
              "application/json": {
                "example": {"resolves":{"state":"resolves","line":"example.org resolves: A 172.66.157.237, A 104.20.26.136 · NOERROR from 1.1.1.1 over DoH; every address in Cloudflare's published ranges","receipts":["r12","r14"],"asked":[]},"domain":"example.org","generatedAt":"2026-10-08T12:00:36.055Z","summary":{"ok":9,"warn":1,"fail":0,"skip":1,"resolves":"resolves"},"checks":[{"id":"ns-consistency","label":"Parent/child NS consistency","status":"ok","detail":"Parent and child agree on all 2 nameservers. None of the 2 nameserver names is an alias or `NXDOMAIN` (names outside the zone answered by Cloudflare 1.1.1.1 over DoH).","source":"doh","receipts":["r05","r06"]}],"receipts":[{"id":"r01","askedAt":"2026-10-08T12:00:34.563Z","source":"fresh","vantage":{"seat":"edge","place":"ATL"},"target":{"id":"198.41.0.4","name":"198.41.0.4"},"endpoint":"198.41.0.4:53","address":"198.41.0.4","addressRecorded":true,"qname":"example.org","qtype":"NS","rd":false,"do":true,"cd":false,"family":"v4","transport":"tcp53","transportRecorded":true,"outcome":"answered","remoteAddress":"198.41.0.4","latencyMs":26,"rcode":"NOERROR","flags":"qr","ad":false,"tc":false,"ede":"none received","answer":[],"authority":["org. 172800 IN NS a2.org.afilias-nst.info.","org. 172800 IN NS b2.org.afilias-nst.org."],"size":777,"error":"none"}],"auth":{"address":"108.162.193.208"},"parentNs":["mitch.ns.cloudflare.com","katelyn.ns.cloudflare.com"]},
                "schema": {
                  "$ref": "#/components/schemas/CheckResult"
                }
              }
            }
          }
        }
      }
    },
    "/api/trace": {
      "get": {
        "operationId": "traceGet",
        "summary": "The same walk as the POST form, from the query string",
        "description": "The walk of POST /api/trace, from the query string. This URL is the api: line of every MCP trace answer. HEAD is not answered.",
        "parameters": [
          { "name": "name", "in": "query", "required": true, "schema": { "type": "string" } },
          { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "default": "A" } }
        ],
        "responses": {
          "200": {
            "description": "Every hop, root to authority, each with the time it was asked, its flags, EDE and size; every dial that got nothing back (failed); every side lookup through 1.1.1.1 (side); notes; warnings; readAt; the final answer",
            "content": { "application/json": { "example": {"query":{"name":"example.com","type":"A"},"readAt":"2026-10-08T12:00:36.237Z","hops":[{"depth":0,"serverIp":"198.41.0.4","serverLabel":"a.root-servers.net","zone":".","latencyMs":28,"at":"2026-10-08T12:00:36.237Z","seq":0,"aa":false,"rcode":0,"rcodeName":"NOERROR","flags":"qr","ad":false,"tc":false,"ede":[],"size":1171,"answerCount":0,"authorityCount":15,"additionalCount":27,"answer":[],"authority":[{"name":"com.","type":"NS","ttl":172800,"data":"l.gtld-servers.net."}],"additional":[{"name":"l.gtld-servers.net.","type":"A","ttl":172800,"data":"192.41.162.30"}]}],"failed":[{"serverIp":"108.162.192.162","serverLabel":"hera.ns.cloudflare.com","zone":"example.com","at":"2026-10-08T12:00:36.305Z","seq":2,"latencyMs":0,"error":"proxy request failed, cannot connect to the specified address","sent":false}],"side":[],"finalServer":{"ip":"108.162.192.162","label":"hera.ns.cloudflare.com","zone":"example.com."},"finalAnswer":[{"name":"example.com.","type":"A","ttl":300,"data":"104.20.23.154"}],"warnings":[],"notes":[],"totalLatencyMs":242}, "schema": { "$ref": "#/components/schemas/TraceResult" } } }
          }
        }
      },
      "post": {
        "operationId": "trace",
        "summary": "Walk the delegation from the root, like dig +trace",
        "description": "Starts at a root server and follows each referral to the authoritative server, then asks it for the name and type, Do53 over TCP from the isitdns edge. A referral with no glue is resolved through 1.1.1.1 over DoH (side). A server the edge could not connect to is listed in failed with its error.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {"name":"www.example.org","type":"AAAA"},
              "schema": {
                "type": "object",
                "required": [
                  "name"
                ],
                "properties": {
                  "name": {
                    "type": "string"
                  },
                  "type": {
                    "type": "string",
                    "default": "A"
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Every hop, root to authority, with the final answer",
            "content": {
              "application/json": {
                "example": {"query":{"name":"www.example.org","type":"AAAA"},"readAt":"2026-10-08T12:00:36.679Z","hops":[{"depth":0,"serverIp":"198.41.0.4","serverLabel":"a.root-servers.net","zone":".","latencyMs":28,"at":"2026-10-08T12:00:36.679Z","seq":0,"aa":false,"rcode":0,"rcodeName":"NOERROR","flags":"qr","ad":false,"tc":false,"ede":[],"size":781,"answerCount":0,"authorityCount":8,"additionalCount":13,"answer":[],"authority":[{"name":"org.","type":"NS","ttl":172800,"data":"a2.org.afilias-nst.info."}],"additional":[{"name":"a2.org.afilias-nst.info.","type":"A","ttl":172800,"data":"199.249.112.1"}]}],"failed":[{"serverIp":"108.162.193.208","serverLabel":"mitch.ns.cloudflare.com","zone":"example.org","at":"2026-10-08T12:00:36.738Z","seq":3,"latencyMs":0,"error":"proxy request failed, cannot connect to the specified address","sent":false}],"side":[{"name":"mitch.ns.cloudflare.com","at":"2026-10-08T12:00:36.734Z","seq":2,"latencyMs":4,"rcode":"NOERROR","answer":[{"name":"mitch.ns.cloudflare.com","type":"A","ttl":86353,"data":"108.162.193.208"}],"error":null}],"finalServer":{"ip":"108.162.193.208","label":"mitch.ns.cloudflare.com","zone":"example.org."},"finalAnswer":[{"name":"www.example.org.","type":"AAAA","ttl":300,"data":"2606:4700:10::ac42:9ded"}],"warnings":[],"notes":["nameserver mitch.ns.cloudflare.com is outside example.org: glue not required (RFC 9471 section 3.1); address 108.162.193.208 from 1.1.1.1 over DoH"],"totalLatencyMs":482},
                "schema": { "$ref": "#/components/schemas/TraceResult" }
              }
            }
          }
        }
      }
    },
    "/api/status": {
      "get": {
        "operationId": "resolverStatus",
        "summary": "The live board: the latest reading of 16 public resolvers",
        "description": "Read by the isitdns probes. updatedAt is when the newest reading was taken.",
        "responses": {
          "200": {
            "description": "The board",
            "content": {
              "application/json": {
                "example": {"updatedAt":"2026-10-08T12:00:02.000Z","vantage":{"colo":"ATL","country":"US"},"servedFrom":{"colo":"ATL","country":"US"},"resolvers":[{"resolverId":"cloudflare","status":"ok","latencyMs":31,"dnssec":true,"answeredCanary":"cloudflare.com","latencyHistory":[32,36],"lastCheckedAt":"2026-10-08T12:00:02.000Z","name":"Cloudflare","ips":["1.1.1.1","1.0.0.1"],"ipv6":["2606:4700:4700::1111","2606:4700:4700::1001"],"fqdn":"one.one.one.one","kind":"public","operator":"cloudflare","featured":true,"category":"mainstream","links":{"docs":"https://developers.cloudflare.com/1.1.1.1/","status":"https://www.cloudflarestatus.com/"},"doh":"https://cloudflare-dns.com/dns-query","strikes":0,"strikesAllTime":0,"legs":[{"leg":"v4/doh","family":"v4","transport":"doh","latencyMs":36,"rcode":"NOERROR","ad":true,"qname":"cloudflare.com","qtype":"A","ede":null,"tc":false,"latencyFrom":"theoracle","seats":["theoracle","theranger"],"state":"ok","since":"2026-10-08T11:57:01.000Z","error":null,"errorFrom":null,"attempts":[{"seat":"theoracle","at":"2026-10-08T12:00:02.000Z","ok":true,"latencyMs":36,"rcode":"NOERROR","ad":true,"tc":false}]}],"global":{"status":"ok","basis":"latest-per-seat","badDomains":[],"slowDomains":[],"domains":{"oracle":"ok","digitalocean":"ok"},"seats":[{"seat":"theoracle","domain":"oracle","latencyMs":24,"status":"ok","ageMs":35298,"from":"legs","at":"2026-10-08T12:00:02.000Z","legs":["v4/doh","v4/dot"],"voted":true}],"p50ByDomain":{"digitalocean":25,"oracle":15},"excludedSeats":[]}}],"digsRun":296,"checksWithIssues":126,"firstProbeAt":"2026-10-07T11:06:01.000Z","uptime":{"adguard":[{"t":1791378000000,"ok":19,"warn":1,"bad":0,"total":20}]},"strikeHours":{},"watchWindowHours":24,"strikesLifetime":2,"strikesSince":"2026-09-30T03:51:01.000Z","seatOrder":["theoracle","thewizard","theranger"],"seatPlaces":{"theoracle":"Phoenix","thewizard":"Amsterdam","theranger":"Singapore"},"domainWords":{"oracle":"theoracle","digitalocean":"digitalocean"},"board":{"word":"no","verdict":"no.","measured":17,"up":17,"bad":0,"partial":0,"total":17,"medianMs":26,"medianFrom":"theoracle","seats":["theoracle","thewizard"],"seatsRead":true,"newestAt":"2026-10-08T12:00:14.662Z"},"reads":{"legs":true,"seats":true,"samples":true}},
                "schema": {
                  "$ref": "#/components/schemas/StatusPayload"
                }
              }
            }
          }
        }
      }
    },
    "/api/activity": {
      "get": {
        "operationId": "activity",
        "summary": "The digs, checks and sweeps run on this site, with 24-hour counts",
        "description": "Counts only: every query run through the dig tool, the domain check and the domain sweep, newest first, with 24-hour counts by source, resolver and record type. A dig row carries its time, record type, resolver, transport, address family, flags and `by`; a check row its time, grade, tally and `by`. `by` is `site` for a person on the page, `auto` for a script or agent, `unknown` for a row written before the log recorded that. `unknown` is never a guess. No row carries the name or address asked, the client address, the subnet, the country or the edge location",
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "schema": {
              "type": "integer",
              "default": 25,
              "maximum": 100
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The feed and its counts",
            "content": {
              "application/json": {
                "example": {"generatedAt":"2026-10-08T12:00:38.653Z","live":true,"windowHours":24,"vantage":"the Cloudflare edge that served each request","counts":{"digs24h":233,"digsBySource":{"auto":228,"site":5},"checks24h":37,"checksBySource":{"auto":36,"site":1},"digsByResolver":[{"resolver":"cloudflare","n":127}],"digsByType":[{"type":"A","n":199}]},"digs":[{"at":"2026-10-08T12:00:33.381Z","type":"MX","resolver":"google","transport":"doh","family":"v4","flags":"dnssec","by":"auto"}],"checks":[{"at":"2026-10-08T12:00:36.055Z","grade":null,"ok":9,"warn":1,"fail":0,"by":"auto"}],"note":"Counts and record types of every query run through the dig tool, the domain check and the domain sweep on this site, newest first. No row carries the name or address asked, the subnet, the country or the edge location. A sweep is one row (type SWEEP, resolver authoritative) and counts once in digs24h."},
                "schema": {
                  "type": "object",
                  "properties": {
                    "generatedAt": {
                      "type": "string",
                      "format": "date-time"
                    },
                    "live": {
                      "type": "boolean"
                    },
                    "windowHours": {
                      "type": "integer"
                    },
                    "vantage": {
                      "type": "string"
                    },
                    "counts": {
                      "type": [
                        "object",
                        "null"
                      ]
                    },
                    "digs": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "at": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "type": {
                            "type": "string"
                          },
                          "resolver": {
                            "type": "string"
                          },
                          "transport": {
                            "type": "string"
                          },
                          "family": {
                            "type": "string"
                          },
                          "flags": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "by": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "checks": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "additionalProperties": false,
                        "properties": {
                          "at": {
                            "type": "string",
                            "format": "date-time"
                          },
                          "grade": {
                            "type": [
                              "string",
                              "null"
                            ]
                          },
                          "ok": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "warn": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "fail": {
                            "type": [
                              "integer",
                              "null"
                            ]
                          },
                          "by": {
                            "type": "string"
                          }
                        }
                      }
                    },
                    "note": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        }
      }
    },
    "/api/sweep": {
      "get": {
        "operationId": "sweepGet",
        "summary": "Ask each authoritative nameserver of a zone every name x type, recursion off, widen on evidence, and compare",
        "description": "The sweep of POST /api/sweep, from the query string, with names and types comma-separated. HEAD is not answered.",
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "names",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Comma-separated labels under domain, @ for domain itself. Default @,www,_dmarc,_acme-challenge; at most 16"
          },
          {
            "name": "types",
            "in": "query",
            "required": false,
            "schema": {
              "type": "string"
            },
            "description": "Comma-separated record types. Default SOA,NS,A,AAAA,MX,TXT,CAA; at most 8"
          }
        ],
        "responses": {
          "200": {
            "description": "Each asked address's answer per name and type (an address never asked reads not_asked), the addresses not asked and the questions not widened, the flags where they differ, the parent's NS and DS, certificate readiness, and the vantage. An answer's `via` is `edge` or the name of the probe that asked (`theoracle`), and its `relayError` starts with that name.",
            "content": {
              "application/json": {
                "example": {"domain":"iana.org","zone":"iana.org","generatedAt":"2026-10-08T12:14:14.121Z","vantage":"Cloudflare edge, ATL","parent":{"server":"199.249.112.1","label":"a2.org.afilias-nst.info","ns":["a.iana-servers.net","b.iana-servers.net"],"ds":["2234 13 2 005B228CE3DAD3486F713EBB9BB6F96A53839BD0E2F5A999D3400E1B7355CE8C"]},"servers":[{"name":"a.iana-servers.net","names":["a.iana-servers.net"],"address":"199.43.135.53","family":"v4","glue":false}],"unasked":[],"results":[{"name":"iana.org","type":"SOA","from":"asked","perServer":{"199.43.135.53":{"rcode":"NOERROR","aa":true,"answers":["iana.org SOA sns.dns.icann.org. noc.dns.icann.org. 2026100801 7200 3600 1209600 3600","iana.org RRSIG SOA 13 2 3600 20261029002422 20261008082013 16626 iana.org. /CyuOBxtBFXomsAhybmbiKCHBIIfgD4d9J6ldxGAqjP93MSU2BVc6jdhSQyFsv16eW8Ryf0Ed7tc6N4PC9cq5w=="],"ttls":{"iana.org SOA sns.dns.icann.org. noc.dns.icann.org. 2026100801 7200 3600 1209600 3600":3600,"iana.org RRSIG SOA 13 2 3600 20261029002422 20261008082013 16626 iana.org. /CyuOBxtBFXomsAhybmbiKCHBIIfgD4d9J6ldxGAqjP93MSU2BVc6jdhSQyFsv16eW8Ryf0Ed7tc6N4PC9cq5w==":3600},"serial":2026100801,"via":"edge","ms":28,"at":"2026-10-08T12:14:03.455Z"}},"flags":[{"flag":"no_answer","servers":{"2001:500:89::53":"timeout after 3500ms"}}]}],"certReadiness":[{"name":"iana.org","caa":{"effective":null,"foundAt":null,"climbed":["iana.org"],"aliasAt":null,"unmeasuredAt":"iana.org","unmeasuredServers":["2001:500:89::53"],"delegatedAt":null,"disagreeAt":null,"note":"CAA at iana.org was not measured at 1 address (not asked, or no usable answer), so what governs issuance for iana.org is not known from this sweep"},"acme":{"owner":"_acme-challenge.iana.org","measured":false,"unmeasuredServers":["2001:500:89::53"],"disagree":false,"txt":[],"cname":[],"note":"_acme-challenge.iana.org was not measured at 1 address (not asked, or no usable answer)"}}],"svcb":[],"limits":{"names":16,"types":8,"servers":8,"queries":256,"queriesPlanned":40},"holdback":{"addressesKnown":8,"addressesSampled":8,"widened":[],"heldBack":[],"paced":[],"unwidened":[],"reason":"8 of 8 addresses were sent at least one question; the sample pass sent to 8 (planned 8: one per nameserver name per family, v4 first); 0 questions were widened, within 256 queries"},"relay":null,"warnings":[],"sources":{"caa":"https://www.rfc-editor.org/rfc/rfc8659.html#section-3","acme":"https://www.rfc-editor.org/rfc/rfc8555.html#section-8.4","ns":"https://www.rfc-editor.org/rfc/rfc1034.html#section-4.2.2"}},
                "schema": { "$ref": "#/components/schemas/SweepResult" }
              }
            }
          },
          "400": {
            "description": "Refused, the reason in error: a name or type that did not validate, or a zone whose nameservers could not be found or whose zone cut could not be confirmed"
          },
          "429": {
            "description": "Rate limited, nothing asked. Retry-After is set."
          },
          "503": {
            "description": "The rate limit could not be read; nothing was asked. Retry-After: 5"
          }
        }
      },
      "post": {
        "operationId": "sweep",
        "summary": "The same sweep, JSON body",
        "description": "Asks a sample of the zone's authoritative addresses each name and type with RD=0 over TCP, from the isitdns edge or a probe named on each answer, and compares the answers server by server. Every question not asked is listed with why. Also reads the CAA set and _acme-challenge TXT and CNAME for each name, and the HTTPS and SVCB records when asked as a type.",
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "example": {"domain":"iana.org","names":["@","www"],"types":["A"]},
              "schema": {
                "type": "object",
                "required": [
                  "domain"
                ],
                "properties": {
                  "domain": {
                    "type": "string"
                  },
                  "names": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  },
                  "types": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    }
                  }
                }
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Each asked address's answer per name and type (an address never asked reads not_asked), the addresses not asked and the questions not widened, the flags where they differ, the parent's NS and DS, certificate readiness, and the vantage. An answer's `via` is `edge` or the name of the probe that asked (`theoracle`), and its `relayError` starts with that name.",
            "content": {
              "application/json": {
                "example": {"domain":"iana.org","zone":"iana.org","generatedAt":"2026-10-08T12:14:25.536Z","vantage":"Cloudflare edge, ATL","parent":{"server":"199.249.112.1","label":"a2.org.afilias-nst.info","ns":["a.iana-servers.net","b.iana-servers.net"],"ds":["2234 13 2 005B228CE3DAD3486F713EBB9BB6F96A53839BD0E2F5A999D3400E1B7355CE8C"]},"servers":[{"name":"a.iana-servers.net","names":["a.iana-servers.net"],"address":"199.43.135.53","family":"v4","glue":false}],"unasked":[],"results":[{"name":"iana.org","type":"A","from":"asked","perServer":{"199.43.135.53":{"rcode":"NOERROR","aa":true,"answers":["iana.org A 192.0.43.8","iana.org RRSIG A 13 2 3600 20261029054958 20261008075421 16626 iana.org. 9VOt6aY2PnDkWWThjeNEo5F7JyUz/cbGOdmalaf2cK3c0alrkAVIEgP/QiCOVcaCJYI91RG7ofbfcmun6oSYlw=="],"ttls":{"iana.org A 192.0.43.8":3600,"iana.org RRSIG A 13 2 3600 20261029054958 20261008075421 16626 iana.org. 9VOt6aY2PnDkWWThjeNEo5F7JyUz/cbGOdmalaf2cK3c0alrkAVIEgP/QiCOVcaCJYI91RG7ofbfcmun6oSYlw==":3600},"via":"edge","ms":27,"at":"2026-10-08T12:14:14.793Z"}},"flags":[{"flag":"no_answer","servers":{"2001:500:89::53":"timeout after 3500ms"}}]}],"certReadiness":[{"name":"iana.org","caa":{"effective":null,"foundAt":null,"climbed":["iana.org"],"aliasAt":null,"unmeasuredAt":"iana.org","unmeasuredServers":["2001:500:89::53"],"delegatedAt":null,"disagreeAt":null,"note":"CAA at iana.org was not measured at 1 address (not asked, or no usable answer), so what governs issuance for iana.org is not known from this sweep"},"acme":{"owner":"_acme-challenge.iana.org","measured":false,"unmeasuredServers":["2001:500:89::53"],"disagree":false,"txt":[],"cname":[],"note":"_acme-challenge.iana.org was not measured at 1 address (not asked, or no usable answer)"}}],"svcb":[],"limits":{"names":16,"types":8,"servers":8,"queries":256,"queriesPlanned":64},"holdback":{"addressesKnown":8,"addressesSampled":8,"widened":[],"heldBack":[],"paced":[],"unwidened":[],"reason":"8 of 8 addresses were sent at least one question; the sample pass sent to 8 (planned 8: one per nameserver name per family, v4 first); 0 questions were widened, within 256 queries"},"relay":null,"warnings":[],"sources":{"caa":"https://www.rfc-editor.org/rfc/rfc8659.html#section-3","acme":"https://www.rfc-editor.org/rfc/rfc8555.html#section-8.4","ns":"https://www.rfc-editor.org/rfc/rfc1034.html#section-4.2.2"}},
                "schema": { "$ref": "#/components/schemas/SweepResult" }
              }
            }
          },
          "400": {
            "description": "Refused, the reason in error: a name or type that did not validate, or a zone whose nameservers could not be found or whose zone cut could not be confirmed"
          },
          "429": {
            "description": "Rate limited, nothing asked. Retry-After is set."
          },
          "503": {
            "description": "The rate limit could not be read; nothing was asked. Retry-After: 5"
          }
        }
      }
    },
    "/api/dnssec-chain": {
      "get": {
        "operationId": "dnssecChain",
        "summary": "The DNSSEC chain walk the MCP dnssec_chain tool makes, root key set (or a supplied anchor's zone) to the answer through one public resolver with checking disabled, a key set a break would rest on read again through a second: the api: link every dnssec_chain answer ends with. Rate-limited; no HEAD",
        "description": "Reads DS and DNSKEY at each zone cut from the root (or a supplied anchor's zone, with nothing above it read) to the answer through one public resolver with checking disabled (Cloudflare's), reads a key set again through a second (Google's) before a break rests on it, and reports the first link that breaks or where the chain goes insecure. Key tags, DS digests and signature windows are compared; signature bytes and denial proofs are not (signaturesVerified and denialProofsChecked are always false). HEAD is not answered.",
        "parameters": [
          { "name": "name", "in": "query", "required": true, "schema": { "type": "string" } },
          { "name": "type", "in": "query", "required": false, "schema": { "type": "string", "default": "A" } },
          { "name": "anchor", "in": "query", "required": false, "description": "A trust anchor, DS <key tag> <algorithm> <digest type> <digest> or DNSKEY <flags> <protocol> <algorithm> <key>, optionally led by its owner name: the walk starts at its zone instead of the root. Percent-encode it: a + in the key sent raw arrives as a space", "schema": { "type": "string" } },
          { "name": "anchor_zone", "in": "query", "required": false, "description": "The zone the anchor belongs to: name or a parent of it", "schema": { "type": "string" } }
        ],
        "responses": {
          "200": { "description": "Each signed zone cut, the first break, and every read of the walk (reads) with its time, rcode, flags and answer", "content": { "application/json": { "example": {"name":"example.com","type":"A","links":[{"zone":".","ds":null,"dsSigs":[],"keys":[{"keyTag":8763,"algorithm":8,"flags":256,"role":"ZSK"}],"keySigs":[{"covers":"DNSKEY","algorithm":8,"labels":0,"keyTag":20326,"signer":".","window":"inside","expiration":"20261022000000","inception":"20261001000000"}],"matched":[{"keyTag":20326,"algorithm":8}],"dsMatch":null,"signer":"root","problems":[],"problemsReadFrom":[],"readFrom":["cloudflare-dns.com"]}],"insecureAt":null,"answer":{"rcode":"NOERROR","records":["A 104.20.23.154","A 172.66.147.243"],"sigs":[{"covers":"A","algorithm":13,"labels":2,"keyTag":34505,"signer":"example.com","window":"inside","expiration":"20261009130053","inception":"20261007110053"}],"denial":0,"problems":[],"problemsReadFrom":[],"alias":null,"dname":null,"readFrom":["cloudflare-dns.com"]},"firstBreak":null,"notRead":null,"notChecked":[],"complete":true,"walkComplete":true,"dsMatched":true,"signatureWindowsInspected":6,"signaturesVerified":false,"denialProofsChecked":false,"server":"cloudflare-dns.com","readAt":"2026-10-08T12:00:53.467Z","reads":[{"name":".","type":"DNSKEY","at":"2026-10-08T12:00:53.467Z","latencyMs":2,"sent":true,"rcode":"NOERROR","flags":"qr rd ra cd","ad":false,"tc":false,"ede":[],"answer":[". 382 IN DNSKEY 256 3 8 AwEAAcorNxNc9t0ue1ZenPjVMRujlQ2YLBJ0pR/4XMjHby9vr03cRxFSKnWpxeg5PL384D9VeqdS1bjrGyTsHtoagzI3NiXFd8sjHMOnZxu5pp/+UBIg7tasYgVMMdUiM1Yu/c+t30d1Qw/v6NYLNnOnywTu6HuUh7Y1sZRq/GZcrxLENXHQoyKpOrOr8R3+qd6wK69IKB80ZBZtkX9rdEqKJk+yYXjEZzZ0zkAFthmNgCreAoU9PVlU66dyOsaLjf3wKUlUm9SNOKs+tK6LuSmRbK6+1T/tPaRaMBSEuv2G6vXfnJ1uyMbGvtpRn/YDcvTjrp6DzE6XyF44QdwJ3oKx4ek=",". 382 IN DNSKEY 256 3 8 AwEAAeCYD6Z7WWKVLeuWgowKP+3g+Gs1cnLKq7a3CaQxQpv8bfuFVI0WnG33qaSH/Mw9IBgifrdzf4XY/DQLnyBJ9MfaOyAWuEaEmYJ+GQPiwVVfstGwSA1McfFJUttTgq2Huu74KARhtA8wPo/N3XcyYQtNhz+qCM5NBb3ecx/naw6sYab9LxS6f2cU0q03++BP5Ks0Uef8WJCa/1izCYE+vMkwoltV+tENa3hpXiZ7jle/xdgaZrPi5ZGmyLVI34g1XVYrNlsCCTmNvFQIfzW5STFQFsQpizczyFn9r3LzSxxPCNwdlCG84bER0BmdwqbF6Tanv+FxMOavrahkj4wIy5k="],"authority":[],"error":null}]}, "schema": { "type": "object", "properties": { "complete": { "type": "boolean", "description": "No read failed, no label was skipped, and notChecked is empty" }, "walkComplete": { "type": "boolean", "description": "The walk reached the answer read with no failed read and no skipped label" }, "dsMatched": { "type": ["boolean", "null"], "description": "null when a supplied anchor did not match; true: at every signed cut below the root (or the anchor's zone) a DS digest matched a DNSKEY a validator uses; false: at one cut every DS was computed against every key read and none matched a usable key (a match only to a revoked key, or to a key without the zone key bit, is false); null: the walk stopped before the target, no cut was read, or a match was not decided (a digest type not computed here, a DS or DNSKEY record not read, fewer keys read than the set holds). Each cut's own result is links[].dsMatch" }, "links": { "type": "array", "description": "One entry per zone cut read, root first (or the supplied anchor's zone first)", "items": { "type": "object", "properties": { "dsMatch": { "type": ["string", "null"], "enum": ["matched", "none", "undecided", null], "description": "This cut's DS to DNSKEY result, as dsMatched describes; null at the root and at a supplied anchor's zone" }, "readFrom": { "type": "array", "items": { "type": "string" }, "description": "The resolvers this cut was read from: server, and a second when it answered a reading of this DNSKEY set" }, "problemsReadFrom": { "type": "array", "items": { "type": "array", "items": { "type": "string" } }, "description": "One per problems entry: the resolvers that problem rests on" }, "keyReadings": { "type": "array", "description": "Present when the DNSKEY set was read twice: each reading's server, rcode (null when no DNS answer came back; notAsked when the read was never sent, http when the DoH server answered an HTTP error), keys (DNSKEY records at the zone), parsed (how many were read as keys) and answers (every record in the answer section)" } } } }, "signatureWindowsInspected": { "type": "integer", "description": "RRSIG windows compared with the read time" }, "signaturesVerified": { "type": "boolean", "const": false, "description": "Signature bytes are not checked against keys" }, "denialProofsChecked": { "type": "boolean", "const": false, "description": "NSEC and NSEC3 records are counted, not checked" }, "firstBreak": { "type": ["object", "null"], "properties": { "at": { "type": "string" }, "why": { "type": "string" }, "readFrom": { "type": "array", "items": { "type": "string" }, "description": "The resolvers the break rests on: the walk's resolver, and the second as well when the break rests on a key set both read alike (the readings are in that link's keyReadings)" } } }, "insecureAt": { "type": ["string", "null"] }, "islandAt": { "type": ["string", "null"], "description": "insecureAt when that zone serves a DNSKEY set signed by its own key: an island of security (RFC 4033 section 2); null when it does not, or when that was not judged (notChecked says why)" }, "anchor": { "type": "object", "description": "Present when an anchor was supplied: zone, kind, record, keyTag, algorithm, match (matched, none, undecided, or null when the read of the anchor zone's key set failed)" }, "notChecked": { "type": "array", "items": { "type": "string" } }, "notRead": { "type": ["string", "null"] } } } } } }
        }
      }
    },
    "/api/registration": {
      "get": {
        "operationId": "registration",
        "summary": "A domain's registration from its registry's RDAP server: the api: link of every registration answer",
        "description": "Finds the registry's RDAP server from the IANA bootstrap file and reads the domain's object: the statuses with what each means for resolution, the dates, the nameservers the registry holds and whether the delegation is signed. Contacts are not returned. 502 when no object came back. HEAD is not answered.",
        "parameters": [
          { "name": "domain", "in": "query", "required": true, "schema": { "type": "string" } }
        ],
        "responses": {
          "200": { "description": "The statuses with what each means for resolution, the dates, the nameservers the registry holds, whether the delegation is signed, and every HTTP read made (reads) with its time and status", "content": { "application/json": { "example": {"domain":"example.com","server":"rdap.verisign.com","status":[{"status":"client delete prohibited","effect":"normal","meaning":"a lock against deletion, normal"}],"events":{"registration":"1995-08-14T04:00:00Z","expiration":"2027-08-13T04:00:00Z","last changed":"2026-08-14T08:01:43Z"},"nameservers":["elliott.ns.cloudflare.com","hera.ns.cloudflare.com"],"delegationSigned":true,"tried":[],"url":"https://rdap.verisign.com/com/v1/domain/example.com","httpStatus":200,"ms":144,"readAt":"2026-10-08T12:00:53.700Z","bootstrap":{"url":"https://data.iana.org/rdap/dns.json","edgeCacheSec":86400},"reads":[{"url":"https://data.iana.org/rdap/dns.json","at":"2026-10-08T12:00:53.700Z","ms":8,"status":200,"error":null}]}, "schema": { "$ref": "#/components/schemas/RegistrationSummary" } } } },
          "502": { "description": "No object came back: the lookup's own words (error) and every HTTP read made (reads)", "content": { "application/json": { "schema": { "type": "object" } } } }
        }
      }
    }
  },
  "components": {
    "schemas": {
      "Error": {
        "type": "object",
        "properties": {
          "error": {
            "type": "string"
          }
        }
      },
      "QueryBody": {
        "type": "object",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "type": {
            "type": "string",
            "default": "A"
          },
          "resolver": {
            "type": "string",
            "default": "cloudflare",
            "description": "A board id, \"all\", or \"custom\" with customIps"
          },
          "customIps": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "maxItems": 6
          },
          "transport": {
            "type": "string",
            "enum": [
              "doh",
              "dot",
              "tcp53",
              "udp53"
            ],
            "default": "doh",
            "description": "doh, dot and tcp53 are asked from the edge; udp53 from a probe, theoracle (Phoenix) unless from names a region"
          },
          "dnssec": {
            "type": "boolean",
            "default": true
          },
          "cd": {
            "type": "boolean",
            "default": false
          },
          "ecs": {
            "type": "string"
          },
          "noRecurse": {
            "type": "boolean",
            "default": false
          },
          "nsid": {
            "type": "boolean",
            "default": false
          },
          "ipFamily": {
            "type": "string",
            "enum": [
              "v4",
              "v6",
              "both"
            ],
            "default": "v4",
            "description": "Address family dialled over dot, tcp53 and udp53 (both: a row per family the resolver has an address in); over DoH the family is not chosen"
          },
          "from": {
            "type": "string",
            "enum": ["north-america", "europe"],
            "description": "Ask over Do53/UDP from the probe in this region (no other transport): north-america is theoracle (Phoenix), europe is thewizard (Amsterdam)"
          },
          "follow": { "type": "boolean", "default": false, "description": "Also walk the CNAME chain from the name, hop by hop, to its addresses: each hop asked for CNAME at Cloudflare's DoH from the edge. The chain is the response's follow, beside results; the text form prints it after the dig. Nothing is walked for a refused name." }
        }
      },
      "RR": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "type": {
            "type": "integer"
          },
          "typeName": {
            "type": "string"
          },
          "class": {
            "type": "integer"
          },
          "ttl": {
            "type": "integer"
          },
          "data": {
            "type": "string",
            "description": "dig-style rendering of the record data"
          }
        }
      },
      "DnsResponse": {
        "type": "object",
        "properties": {
          "rcode": {
            "type": "integer"
          },
          "rcodeName": {
            "type": "string"
          },
          "qr": {
            "type": "boolean"
          },
          "aa": {
            "type": "boolean"
          },
          "tc": {
            "type": "boolean"
          },
          "rd": {
            "type": "boolean"
          },
          "ra": {
            "type": "boolean"
          },
          "ad": {
            "type": "boolean"
          },
          "cd": {
            "type": "boolean"
          },
          "question": {
            "type": "object"
          },
          "answer": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RR"
            }
          },
          "authority": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RR"
            }
          },
          "additional": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RR"
            }
          },
          "ede": {
            "type": "array",
            "description": "Extended DNS Errors (RFC 8914), present only when the server sent them"
          },
          "nsid": {
            "type": "string"
          }
        }
      },
      "RunResult": {
        "type": "object",
        "properties": {
          "resolver": {
            "type": "object",
            "properties": {
              "id": {
                "type": "string"
              },
              "name": {
                "type": "string"
              },
              "ips": {
                "type": "array",
                "items": {
                  "type": "string"
                }
              }
            }
          },
          "latencyMs": {
            "type": "number",
            "description": "Round trip in milliseconds, measured where vantage says. A row from one of our probes carries that probe's own round trip to the resolver, not comparable with the edge rows beside it. Zero is not a measurement: it means nothing reached a resolver, which is every row carrying requestError and every row whose probe failed."
          },
          "vantage": {
            "type": "object",
            "description": "Where this row was measured. Present on every result that was dialled, and absent only where nothing was: a skipped row and a request that could not be built carry none.",
            "properties": {
              "seat": {
                "type": "string",
                "description": "`edge` for the Cloudflare edge, or the name of the probe that asked (theoracle, thewizard)."
              },
              "label": {
                "type": "string",
                "description": "Human name of the vantage, e.g. theoracle or \"the isitdns edge\"."
              },
              "place": {
                "type": "string",
                "description": "Where the row was asked from: the Cloudflare location code for an edge row (e.g. DFW), else the probe's place (e.g. Phoenix); `unavailable from this vantage` or `not measured` when there is none."
              }
            }
          },
          "ipUsed": {
            "type": "string"
          },
          "response": {
            "$ref": "#/components/schemas/DnsResponse"
          },
          "error": {
            "type": "string"
          },
          "skipped": {
            "type": "boolean"
          },
          "skippedReason": {
            "type": "string"
          },
          "transportUsed": {
            "type": "string",
            "enum": [
              "doh",
              "dot",
              "tcp53",
              "udp53"
            ],
            "description": "The transport of the last attempt: the one that answered when error is absent, else the last that failed. Equal to the requested transport except with resolver=all, where a row the requested transport cannot reach is asked over one it can. Absent when nothing was dialled (see requestError)."
          },
          "attempts": {
            "type": "array",
            "description": "Transports tried before this answer, oldest first, each with its error; present only when one failed. With no error, the row answered on a later transport. With an error and two or more attempts, no transport tried reached the resolver from the isitdns edge; with one, only that transport was tried.",
            "items": {
              "type": "object",
              "properties": {
                "transport": {
                  "type": "string",
                  "enum": [
                    "doh",
                    "dot",
                    "tcp53",
                    "udp53"
                  ]
                },
                "error": {
                  "type": "string"
                }
              }
            }
          },
          "requestError": {
            "type": "boolean",
            "description": "The query could not be built, so no socket was opened and no transport was used. Never set alongside transportUsed or attempts: those describe dials, and there was none. A malformed ECS string is a 400, never a requestError."
          },
          "at": {
            "type": "string",
            "format": "date-time",
            "description": "When this row's dial began (UTC, milliseconds); for a row nothing was dialled for, when it was refused."
          }
        }
      },
      "QueryResult": {
        "type": "object",
        "properties": {
          "askedAt": {
            "type": "string",
            "format": "date-time",
            "description": "When the question was asked, taken before the first dial (UTC, milliseconds)."
          },
          "query": {
            "type": "object",
            "description": "The question as asked, after validation"
          },
          "results": {
            "type": "array",
            "items": {
              "$ref": "#/components/schemas/RunResult"
            }
          },
          "omitted": {
            "type": "array",
            "description": "Board rows no transport can reach, each with why.",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "name": {
                  "type": "string"
                },
                "reason": {
                  "type": "string"
                }
              }
            }
          },
          "agreement": {
            "type": "object",
            "description": "resolver=all only: the rows that answered, grouped by rcode, answer data (RRSIG and TTL aside) and AD (groups); rows asked with no reply (noAnswer); rows not asked (notMeasured); rows that answered on another transport than the one asked (rungs, and in their id).",
            "properties": {
              "groups": {
                "type": "array",
                "items": {
                  "type": "object",
                  "properties": {
                    "ids": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "rcode": {
                      "type": "string"
                    },
                    "answer": {
                      "type": "array",
                      "items": {
                        "type": "string"
                      }
                    },
                    "ad": {
                      "type": "boolean"
                    }
                  }
                }
              },
              "noAnswer": {
                "type": "array",
                "description": "Rows asked with no reply, each with its error.",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "why": {
                      "type": "string"
                    }
                  }
                }
              },
              "notMeasured": {
                "type": "array",
                "description": "Rows not asked, each with why.",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "why": {
                      "type": "string"
                    }
                  }
                }
              },
              "rungs": {
                "type": "array",
                "description": "Rows that answered on another transport than the one asked: the id it carries in groups, the transport it answered on, and each transport that failed first, with its error.",
                "items": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "answeredOver": {
                      "type": "string"
                    },
                    "failed": {
                      "type": "array",
                      "items": {
                        "type": "object",
                        "properties": {
                          "transport": {
                            "type": "string"
                          },
                          "error": {
                            "type": "string"
                          }
                        }
                      }
                    }
                  }
                }
              }
            }
          },
          "follow": { "$ref": "#/components/schemas/AliasChain" }
        }
      },
      "AliasChain": { "type": "object", "description": "The CNAME chain from the asked name (follow=true only), or { error } when the walk failed.", "properties": {
        "asked": { "type": "string" },
        "hops": { "type": "array", "items": { "type": "object", "properties": { "owner": { "type": "string" }, "target": { "type": "string" }, "ttl": { "type": "integer" } } } },
        "end": { "type": "object", "description": "How the chain ends: kind address (a, aaaa, failed, inside), no-address, failed (rcode), nxdomain, loop, too-long, inside or not-read (why), with the name it ended at", "properties": { "kind": { "type": "string", "enum": ["address", "no-address", "failed", "nxdomain", "loop", "too-long", "inside", "not-read"] }, "name": { "type": "string" } } },
        "trailingDot": { "type": "array", "items": { "type": "string" }, "description": "Targets that read like a name written without its trailing dot" },
        "server": { "type": "string" },
        "readAt": { "type": "string", "format": "date-time" },
        "reads": { "type": "array", "items": { "type": "object" }, "description": "Every question the walk asked, in order, each with its time, rcode, answer and latency, or its error" },
        "error": { "type": "string" } } },
      "TraceResult": { "type": "object", "description": "One delegation walk from the root", "properties": {
        "query": { "type": "object", "properties": { "name": { "type": "string" }, "type": { "type": "string" } } },
        "readAt": { "type": "string", "format": "date-time", "description": "When the walk started" },
        "hops": { "type": "array", "items": { "type": "object" }, "description": "Every server asked, root to authority, each with the zone, the time it was asked, its flags, EDE, size, what it returned and via (the probe that asked; absent: the isitdns edge)" },
        "failed": { "type": "array", "items": { "type": "object" }, "description": "Every dial that got nothing back, with its error" },
        "side": { "type": "array", "items": { "type": "object" }, "description": "Every side lookup through 1.1.1.1, with its time, rcode and answer" },
        "finalServer": { "type": "object", "properties": { "ip": { "type": "string" }, "label": { "type": "string" }, "zone": { "type": "string" } } },
        "finalAnswer": { "type": ["array", "null"], "items": { "type": "object" }, "description": "The authority's answer section, null when the walk stopped" },
        "warnings": { "type": "array", "items": { "type": "string" }, "description": "Faults of the delegation" },
        "notes": { "type": "array", "items": { "type": "string" }, "description": "Facts of the walk that are not faults" },
        "totalLatencyMs": { "type": "integer" },
        "noPublicAddress": { "type": "object", "description": "Present when no glue address the parent gave is public", "properties": { "zone": { "type": "string" }, "servers": { "type": "array", "items": { "type": "string" } }, "glue": { "type": "array", "items": { "type": "string" } } } },
        "error": { "type": "string", "description": "Present when an error stopped the walk; hops holds the walk up to it" } } },
      "SweepResult": { "type": "object", "description": "One sweep of a zone's own servers", "properties": {
        "domain": { "type": "string" },
        "zone": { "type": "string" },
        "generatedAt": { "type": "string", "format": "date-time" },
        "vantage": { "type": "string", "description": "Where the sweep asked from: the Cloudflare edge, then each probe that answered with its address count" },
        "parent": { "type": "object", "description": "The parent's server, its NS set and its DS set (ds null when not measured)", "properties": { "server": { "type": "string" }, "label": { "type": "string" }, "ns": { "type": "array", "items": { "type": "string" } }, "ds": { "type": ["array", "null"], "items": { "type": "string" } }, "via": { "type": "string", "description": "The probe the parent was read from when the edge could not dial it; absent: the edge" } } },
        "servers": { "type": "array", "items": { "type": "object" }, "description": "Each nameserver address asked" },
        "unasked": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "reason": { "type": "string" } } }, "description": "Delegated nameservers with no address found" },
        "results": { "type": "array", "items": { "type": "object" }, "description": "Each name and type, each address's answer and the flags where they differ" },
        "certReadiness": { "type": "array", "items": { "type": "object" }, "description": "Per name: the CAA set that governs it and its _acme-challenge TXT and CNAME, each with a note" },
        "svcb": { "type": "array", "items": { "type": "object" }, "description": "HTTPS and SVCB records read from the answers, one note each" },
        "limits": { "type": "object", "description": "The sweep's caps and the queries planned" },
        "holdback": { "type": "object", "description": "The sample: addresses known, addresses asked, and each address and question not asked with why" },
        "relay": { "type": ["object", "null"], "description": "For addresses the edge could not dial: what each probe asked and how many answered, or null when no address needed a probe" },
        "warnings": { "type": "array", "items": { "type": "string" } },
        "sources": { "type": "object", "additionalProperties": { "type": "string" } } } },
      "RegistrationSummary": { "type": "object", "description": "One RDAP lookup. A field no read measured is the string \"not measured\"", "properties": {
        "domain": { "type": "string" },
        "server": { "type": "string" },
        "status": { "type": "array", "items": { "type": "object", "properties": { "status": { "type": "string" }, "effect": { "type": "string" }, "meaning": { "type": "string" } } } },
        "events": { "type": "object", "additionalProperties": { "type": "string" } },
        "nameservers": { "type": ["array", "null"], "items": { "type": "string" }, "description": "null when the registry sent no nameservers member" },
        "delegationSigned": { "type": ["boolean", "null"] },
        "tried": { "type": "array", "items": { "type": "string" }, "description": "Names walked past that got HTTP 404" },
        "walked": { "type": "array", "items": { "type": "object", "properties": { "name": { "type": "string" }, "status": { "type": "integer" } } }, "description": "Every name walked past on the way to the registered domain, with the HTTP status it got (404 or 400)" },
        "url": { "type": "string" },
        "httpStatus": { "type": ["integer", "string"] },
        "ms": { "type": ["integer", "string"] },
        "readAt": { "type": "string", "format": "date-time" },
        "bootstrap": { "type": "object", "properties": { "url": { "type": "string" }, "edgeCacheSec": { "type": "integer" } } },
        "reads": { "type": "array", "items": { "type": "object", "properties": { "url": { "type": "string" }, "at": { "type": "string" }, "ms": { "type": "integer" }, "status": { "type": ["integer", "null"] }, "error": { "type": ["string", "null"] } } } } } },
      "CheckResult": {
        "type": "object",
        "required": ["resolves", "domain", "generatedAt", "summary", "checks"],
        "properties": {
          "resolves": {
            "type": "object",
            "description": "Whether the name resolves, as the audit's reads of the name came back: the line check_domain prints first",
            "required": ["state", "line", "receipts", "asked"],
            "properties": {
              "state": { "type": "string", "enum": ["resolves", "split", "alias", "no address", "NXDOMAIN", "lame", "no answer", "error", "mixed", "not read"] },
              "line": { "type": "string" },
              "receipts": { "type": "array", "items": { "type": "string" }, "description": "The ids of the receipts the line rests on" },
              "asked": { "type": "array", "items": { "type": "string" }, "description": "The ids of the reads made for this line alone, each asked or NOT ASKED with its reason" }
            }
          },
          "domain": {
            "type": "string",
            "description": "The name that was asked about."
          },
          "generatedAt": {
            "type": "string"
          },
          "summary": {
            "type": "object",
            "description": "The count of rows by status (ok, warn, fail, skip), and resolves: the state of the first line, the same word as resolves.state",
            "required": ["ok", "warn", "fail", "skip", "resolves"],
            "properties": {
              "ok": { "type": "integer" },
              "warn": { "type": "integer" },
              "fail": { "type": "integer" },
              "skip": { "type": "integer" },
              "resolves": { "type": "string", "enum": ["resolves", "split", "alias", "no address", "NXDOMAIN", "lame", "no answer", "error", "mixed", "not read"] }
            }
          },
          "checks": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "id": {
                  "type": "string"
                },
                "label": {
                  "type": "string"
                },
                "status": {
                  "type": "string",
                  "enum": [
                    "ok",
                    "warn",
                    "fail",
                    "skip"
                  ]
                },
                "detail": {
                  "type": "string"
                },
                "source": {
                  "type": "string",
                  "enum": [
                    "auth",
                    "doh"
                  ],
                  "description": "auth = asked the authoritative server; doh = asked 1.1.1.1 over DoH."
                },
                "subject": {
                  "type": "string",
                  "description": "The name this check asked about, present only when it is not `domain`: a zone check of a hostname is read at its zone."
                },
                "next": {
                  "type": "array",
                  "description": "The one reading to take next, present only on a warn or fail row that has one: tool (trace, dnssec_chain or sweep_domain), args (that tool's call) and command (the dig-shaped line the texts print as next:).",
                  "items": { "type": "object", "required": ["tool", "args", "command"], "properties": { "tool": { "type": "string", "enum": ["dig", "trace", "dnssec_chain", "sweep_domain", "check_domain"] }, "args": { "type": "object" }, "command": { "type": "string" } } }
                }
              }
            }
          },
          "zone": {
            "type": "string",
            "description": "The zone that holds `domain` (the deepest delegation at or above it), present only when it is not `domain`. Absent for a registrable domain, and absent when that zone was not read, in which case each check about the zone says so. When present, the answer mixes checks about this zone with checks about the name itself, and each check says which it is."
          }
        },
        "description": "What each check found. There is no score and no letter grade."
      },
      "StatusPayload": {
        "type": "object",
        "properties": {
          "updatedAt": {
            "type": [
              "string",
              "null"
            ]
          },
          "vantage": {
            "type": "object"
          },
          "resolvers": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "board": {
            "type": "object",
            "description": "The board's label over this body: `word`, `verdict`, `measured`, `up`, `bad`, `partial`, `total`, `medianMs`, `medianFrom`, `seats`, `seatsRead`, `newestAt`."
          },
          "reads": {
            "type": "object",
            "description": "Whether the leg and probe reads succeeded; with either false, no row carries global.",
            "properties": {
              "legs": {
                "type": "boolean"
              },
              "seats": {
                "type": "boolean"
              }
            }
          },
          "domainWords": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            },
            "description": "The printed name of each domain id in a row's global."
          }
        }
      }
    }
  }
}
