{
  "openapi": "3.1.0",
  "info": {
    "title": "DNS Super API",
    "description": "Check domains, DNS, email setup, certificates and websites. Authenticate with `Authorization: Bearer <api key>`. Every call's price in credits is in its description; cached answers cost the same and failed upstream lookups cost nothing.",
    "version": "0.1.0"
  },
  "paths": {
    "/v1/dns": {
      "get": {
        "tags": [
          "Domain and DNS"
        ],
        "summary": "DNS lookup",
        "description": "Records for a domain grouped by type, with TTLs, CNAME chain, DNSSEC state and findings. Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for the lowest record TTL, between 1 minute and 1 hour; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "get_dns_v1_dns_get",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 2048,
              "description": "A domain name or a URL",
              "examples": [
                "example.com"
              ],
              "title": "Domain"
            },
            "description": "A domain name or a URL"
          },
          {
            "name": "types",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 200
                },
                {
                  "type": "null"
                }
              ],
              "description": "Comma-separated record types; default A, AAAA, CNAME, MX, NS, TXT, SOA, CAA",
              "examples": [
                "A,MX"
              ],
              "title": "Types"
            },
            "description": "Comma-separated record types; default A, AAAA, CNAME, MX, NS, TXT, SOA, CAA"
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask DNS again",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask DNS again"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ToolResponse"
                },
                "example": {
                  "tool": "dns-lookup",
                  "target": "example.com",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 1,
                  "summary": "example.com resolves to 2 IPv4 addresses and receives mail through 1 MX host.",
                  "findings": [
                    {
                      "id": "dns.dnssec_unsigned",
                      "severity": "info",
                      "title": "Your domain isn't signed with DNSSEC",
                      "detail": "Answers for example.com carry no DNSSEC signatures, so resolvers can't check that nobody changed them on the way.",
                      "fix": "Turn on DNSSEC at your DNS provider, then add the DS record it gives you at your registrar. Many providers do both for you in one step."
                    }
                  ],
                  "data": {
                    "name": "example.com",
                    "unicode": "example.com",
                    "nxdomain": false,
                    "dnssec": "insecure",
                    "wildcard": false,
                    "records": {
                      "A": [
                        {
                          "name": "example.com",
                          "ttl": 300,
                          "value": "192.0.2.10"
                        },
                        {
                          "name": "example.com",
                          "ttl": 300,
                          "value": "192.0.2.11"
                        }
                      ],
                      "MX": [
                        {
                          "name": "example.com",
                          "ttl": 3600,
                          "value": "10 mail.example.com"
                        }
                      ]
                    },
                    "query_status": {
                      "A": "ok",
                      "MX": "ok"
                    },
                    "cname_chain": [],
                    "hosts": {
                      "mail.example.com": {
                        "A": [
                          "192.0.2.25"
                        ],
                        "AAAA": [],
                        "roles": [
                          "MX"
                        ],
                        "status": "ok"
                      }
                    },
                    "caa_inherited": [],
                    "min_ttl": 300
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "x-dnssuper-tool": "dns-lookup",
        "x-dnssuper-price": "Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for the lowest record TTL, between 1 minute and 1 hour; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "lookup_dns",
          "example": "example.com resolves to 2 IPv4 addresses and receives mail through 1 MX host.\nA: 192.0.2.10, 192.0.2.11 (TTL 300)\nMX: 10 mail.example.com (TTL 3600)\nDNSSEC: insecure\n- info: Your domain isn't signed with DNSSEC\nCredits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/account": {
      "get": {
        "tags": [
          "Account"
        ],
        "summary": "Account, balance and recent usage",
        "description": "Your account, credit balance and last 20 calls, newest first. No charge.",
        "operationId": "get_account_v1_account_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccountResponse"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/whois": {
      "get": {
        "tags": [
          "Domain and DNS"
        ],
        "summary": "WHOIS / RDAP",
        "description": "Who registered a domain, with which registrar, when it expires, its statuses, nameservers and DNSSEC flag, from the registry's RDAP or WHOIS service, with personal contact data removed. Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 1 hour; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_whois_lookup",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "A domain or URL; reduced to its registrable part.",
              "examples": [
                "example.com"
              ],
              "title": "Domain"
            },
            "description": "A domain or URL; reduced to its registrable part."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WhoisLookupResponse"
                },
                "example": {
                  "tool": "whois-lookup",
                  "target": "verisign.com",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 2,
                  "summary": "verisign.com is registered with CSC Corporate Domains, Inc. until 1 June 2034 (in 2755 days). Transfers are locked and DNSSEC is on.",
                  "findings": [],
                  "data": {
                    "name": "verisign.com",
                    "unicode": "verisign.com",
                    "tld": "com",
                    "tier": "A",
                    "source": "rdap",
                    "registered": true,
                    "registrar": {
                      "name": "CSC Corporate Domains, Inc.",
                      "iana_id": 299,
                      "url": "https://www.cscdbs.example.net",
                      "abuse_email": "domainabuse@cscglobal.com",
                      "abuse_phone": "+1.8887802723"
                    },
                    "created": "1995-06-02T04:00:00Z",
                    "updated": "2025-02-07T17:08:30Z",
                    "expires": "2034-06-01T04:00:00Z",
                    "age_days": 11488,
                    "days_to_expiry": 2755,
                    "statuses": [
                      {
                        "code": "clientDeleteProhibited",
                        "meaning": "The registrar has locked deletion",
                        "set_by": "registrar"
                      },
                      {
                        "code": "clientTransferProhibited",
                        "meaning": "The registrar has locked transfers",
                        "set_by": "registrar"
                      },
                      {
                        "code": "clientUpdateProhibited",
                        "meaning": "The registrar has locked changes",
                        "set_by": "registrar"
                      },
                      {
                        "code": "serverDeleteProhibited",
                        "meaning": "The registry has locked deletion",
                        "set_by": "registry"
                      },
                      {
                        "code": "serverTransferProhibited",
                        "meaning": "The registry has locked transfers",
                        "set_by": "registry"
                      },
                      {
                        "code": "serverUpdateProhibited",
                        "meaning": "The registry has locked changes",
                        "set_by": "registry"
                      }
                    ],
                    "nameservers": [
                      "av1.nstld.com",
                      "av2.nstld.com",
                      "av3.nstld.com",
                      "av4.nstld.com"
                    ],
                    "dnssec": true,
                    "redacted_fields": [],
                    "unpublished_fields": [],
                    "unparsed_fields": [],
                    "attempts": [
                      {
                        "method": "rdap",
                        "server": "rdap.verisign.com",
                        "outcome": "found",
                        "http_status": 200,
                        "elapsed_ms": 12
                      },
                      {
                        "method": "rdap-registrar",
                        "server": "rdap.cscglobal.com",
                        "outcome": "found",
                        "http_status": 200,
                        "elapsed_ms": 12
                      }
                    ],
                    "raw": {
                      "format": "rdap-json",
                      "registry": {
                        "objectClassName": "domain",
                        "handle": "2703255_DOMAIN_COM-VRSN",
                        "ldhName": "VERISIGN.COM",
                        "links": [
                          {
                            "value": "https://rdap.verisign.com/com/v1/domain/verisign.com",
                            "rel": "self",
                            "href": "https://rdap.verisign.com/com/v1/domain/verisign.com",
                            "type": "application/rdap+json"
                          },
                          {
                            "value": "https://rdap.verisign.com/com/v1/domain/verisign.com",
                            "rel": "related",
                            "href": "https://rdap.cscglobal.com/dbs/rdap-api/v1/domain/VERISIGN.COM",
                            "type": "application/rdap+json"
                          }
                        ],
                        "status": [
                          "client delete prohibited",
                          "client transfer prohibited",
                          "client update prohibited",
                          "server delete prohibited",
                          "server transfer prohibited",
                          "server update prohibited"
                        ],
                        "entities": [
                          {
                            "objectClassName": "entity",
                            "handle": "299",
                            "roles": [
                              "registrar"
                            ],
                            "links": [
                              {
                                "href": "http://cscdbs.com",
                                "type": "text/html",
                                "value": "https://rdap.cscglobal.com/dbs/rdap-api/v1/",
                                "rel": "about"
                              }
                            ],
                            "publicIds": [
                              {
                                "type": "IANA Registrar ID",
                                "identifier": "299"
                              }
                            ],
                            "vcardArray": [
                              "vcard",
                              [
                                [
                                  "version",
                                  {},
                                  "text",
                                  "4.0"
                                ],
                                [
                                  "fn",
                                  {},
                                  "text",
                                  "CSC Corporate Domains, Inc."
                                ]
                              ]
                            ],
                            "entities": [
                              {
                                "objectClassName": "entity",
                                "roles": [
                                  "abuse"
                                ],
                                "vcardArray": [
                                  "vcard",
                                  [
                                    [
                                      "version",
                                      {},
                                      "text",
                                      "4.0"
                                    ],
                                    [
                                      "fn",
                                      {},
                                      "text",
                                      ""
                                    ],
                                    [
                                      "tel",
                                      {
                                        "type": "voice"
                                      },
                                      "uri",
                                      "tel:8887802723"
                                    ],
                                    [
                                      "email",
                                      {},
                                      "text",
                                      "domainabuse@cscglobal.com"
                                    ]
                                  ]
                                ]
                              }
                            ]
                          }
                        ],
                        "events": [
                          {
                            "eventAction": "registration",
                            "eventDate": "1995-06-02T04:00:00Z"
                          },
                          {
                            "eventAction": "expiration",
                            "eventDate": "2034-06-01T04:00:00Z"
                          },
                          {
                            "eventAction": "last changed",
                            "eventDate": "2025-02-07T17:08:30Z"
                          },
                          {
                            "eventAction": "last update of RDAP database",
                            "eventDate": "2026-11-14T18:32:50Z"
                          }
                        ],
                        "secureDNS": {
                          "delegationSigned": true,
                          "dsData": [
                            {
                              "keyTag": 55204,
                              "algorithm": 8,
                              "digestType": 2,
                              "digest": "206D88653C43D99BF4567BBD7DF9C078DB357F59AA183741024D345723052E88"
                            }
                          ]
                        },
                        "nameservers": [
                          {
                            "objectClassName": "nameserver",
                            "ldhName": "AV1.NSTLD.COM"
                          },
                          {
                            "objectClassName": "nameserver",
                            "ldhName": "AV2.NSTLD.COM"
                          },
                          {
                            "objectClassName": "nameserver",
                            "ldhName": "AV3.NSTLD.COM"
                          },
                          {
                            "objectClassName": "nameserver",
                            "ldhName": "AV4.NSTLD.COM"
                          }
                        ],
                        "rdapConformance": [
                          "rdap_level_0",
                          "icann_rdap_technical_implementation_guide_1",
                          "icann_rdap_response_profile_1"
                        ],
                        "notices": [
                          {
                            "title": "Terms of Service",
                            "description": [
                              "Service subject to Terms of Use."
                            ],
                            "links": [
                              {
                                "href": "https://www.verisign.com/domain-names/registration-data-access-protocol/terms-service/index.xhtml",
                                "type": "text/html",
                                "value": "https://rdap.verisign.com/com/v1/domain/verisign.com",
                                "rel": "terms-of-service"
                              }
                            ]
                          },
                          {
                            "title": "Status Codes",
                            "description": [
                              "For more information on domain status codes, please visit https://icann.org/epp"
                            ],
                            "links": [
                              {
                                "href": "https://icann.org/epp",
                                "type": "text/html",
                                "value": "https://rdap.verisign.com/com/v1/domain/verisign.com",
                                "rel": "glossary"
                              }
                            ]
                          },
                          {
                            "title": "RDDS Inaccuracy Complaint Form",
                            "description": [
                              "URL of the ICANN RDDS Inaccuracy Complaint Form: https://icann.org/wicf"
                            ],
                            "links": [
                              {
                                "href": "https://icann.org/wicf",
                                "type": "text/html",
                                "value": "https://rdap.verisign.com/com/v1/domain/verisign.com",
                                "rel": "help"
                              }
                            ]
                          }
                        ]
                      },
                      "registrar": {
                        "objectClassName": "domain",
                        "ldhName": "VERISIGN.COM",
                        "handle": "synthetic",
                        "status": [
                          "client transfer prohibited"
                        ],
                        "events": [
                          {
                            "eventAction": "registration",
                            "eventDate": "1995-06-02T04:00:00Z"
                          },
                          {
                            "eventAction": "expiration",
                            "eventDate": "2034-06-01T04:00:00Z"
                          },
                          {
                            "eventAction": "last changed",
                            "eventDate": "2025-02-07T17:08:30Z"
                          }
                        ],
                        "entities": [
                          {
                            "objectClassName": "entity",
                            "roles": [
                              "registrar"
                            ],
                            "publicIds": [
                              {
                                "type": "IANA Registrar ID",
                                "identifier": "299"
                              }
                            ],
                            "links": [
                              {
                                "rel": "about",
                                "href": "https://www.cscdbs.example.net",
                                "type": "text/html"
                              }
                            ],
                            "vcardArray": [
                              "vcard",
                              [
                                [
                                  "version",
                                  {},
                                  "text",
                                  "4.0"
                                ],
                                [
                                  "fn",
                                  {},
                                  "text",
                                  "CSC Corporate Domains, Inc."
                                ]
                              ]
                            ],
                            "entities": [
                              {
                                "objectClassName": "entity",
                                "roles": [
                                  "abuse"
                                ],
                                "vcardArray": [
                                  "vcard",
                                  [
                                    [
                                      "version",
                                      {},
                                      "text",
                                      "4.0"
                                    ],
                                    [
                                      "fn",
                                      {},
                                      "text",
                                      "Abuse"
                                    ],
                                    [
                                      "tel",
                                      {
                                        "type": "voice"
                                      },
                                      "uri",
                                      "tel:+1.8887802723"
                                    ],
                                    [
                                      "email",
                                      {},
                                      "text",
                                      "domainabuse@cscglobal.com"
                                    ]
                                  ]
                                ]
                              }
                            ]
                          },
                          {
                            "objectClassName": "entity",
                            "roles": [
                              "registrant"
                            ],
                            "removed": "contact details removed by DNS Super"
                          }
                        ],
                        "nameservers": [
                          {
                            "objectClassName": "nameserver",
                            "ldhName": "AV1.NSTLD.COM",
                            "entities": [
                              {
                                "objectClassName": "entity",
                                "roles": [
                                  "technical"
                                ],
                                "removed": "contact details removed by DNS Super"
                              }
                            ]
                          }
                        ],
                        "secureDNS": {
                          "delegationSigned": true
                        }
                      },
                      "scrubbed": true
                    }
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "x-dnssuper-tool": "whois-lookup",
        "x-dnssuper-price": "Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for up to 1 hour; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "lookup_whois",
          "example": "verisign.com is registered with CSC Corporate Domains, Inc. until 1 June 2034 (in 2755 days). Transfers are locked and DNSSEC is on.\nRegistrar: CSC Corporate Domains, Inc. (IANA 299)\nCreated 1995-06-02 | expires 2034-06-01 (in 2755 days) | updated 2025-02-07\nStatus: clientDeleteProhibited (The registrar has locked deletion)\nStatus: clientTransferProhibited (The registrar has locked transfers)\nStatus: clientUpdateProhibited (The registrar has locked changes)\nStatus: serverDeleteProhibited (The registry has locked deletion) +2 more\nNameservers: av1.nstld.com, av2.nstld.com, av3.nstld.com +1 more\nDNSSEC: on | source RDAP, tier A\nNo issues found.\nCredits: 2 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/availability": {
      "get": {
        "tags": [
          "Domain and DNS"
        ],
        "summary": "Availability",
        "description": "Whether a domain name is available, taken, restricted or unknown, how certain that is, and the steps that decided it (DNS at the TLD's own servers, then the registry). Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached per account for up to 10 minutes; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_domain_availability",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "The domain name to check, such as brightidea.io.",
              "examples": [
                "example.com"
              ],
              "title": "Domain"
            },
            "description": "The domain name to check, such as brightidea.io."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DomainAvailabilityResponse"
                },
                "example": {
                  "tool": "domain-availability",
                  "target": "brightidea.io",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 1,
                  "summary": "brightidea.io is available. The .io registry has no record of it; check the price at your registrar before you buy.",
                  "findings": [
                    {
                      "id": "availability.confirm_price",
                      "severity": "info",
                      "title": "Check the price before you buy",
                      "detail": "",
                      "fix": "Registrars set their own prices, and some names cost more than usual; check the price at your registrar before you buy."
                    }
                  ],
                  "data": {
                    "name": "brightidea.io",
                    "unicode": "brightidea.io",
                    "tld": "io",
                    "tier": "A",
                    "verdict": "available",
                    "certainty": "confirmed",
                    "reason": "registry_not_found",
                    "may_become_available": false,
                    "statuses": [],
                    "source": "rdap",
                    "steps": [
                      {
                        "method": "dns-parent",
                        "server": "192.0.2.200",
                        "result": "nxdomain",
                        "elapsed_ms": 12
                      },
                      {
                        "method": "rdap",
                        "server": "rdap.identitydigital.services",
                        "result": "not_found",
                        "elapsed_ms": 12
                      }
                    ],
                    "price_note": true
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "x-dnssuper-tool": "domain-availability",
        "x-dnssuper-price": "Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached per account for up to 10 minutes; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "check_availability",
          "example": "brightidea.io is available. The .io registry has no record of it; check the price at your registrar before you buy.\nbrightidea.io: Available (confirmed; the registry has no record)\nChecked: dns-parent -> rdap\n- info: Check the price before you buy\nCredits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/dnssec": {
      "get": {
        "tags": [
          "Domain and DNS"
        ],
        "summary": "DNSSEC and nameservers",
        "description": "The delegation at the parent, every nameserver's answers over UDP and TCP, serials and glue, and the DNSSEC chain of trust with the reason when it breaks. Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 5 minutes; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_dnssec_checker",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "A domain or URL; the zone it belongs to is checked.",
              "examples": [
                "example.com"
              ],
              "title": "Domain"
            },
            "description": "A domain or URL; the zone it belongs to is checked."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DnssecCheckerResponse"
                },
                "example": {
                  "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
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "x-dnssuper-tool": "dnssec-checker",
        "x-dnssuper-price": "Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for up to 5 minutes; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "check_dnssec",
          "example": "example.com is DNSSEC-signed and validates, and 2 of 2 nameservers answer correctly.\nDNSSEC: secure (zone example.com, parent com)\nDS: key 65437, algorithm 13 (ECDSAP256SHA256), digest type 2, matches a served key\nKeys: 65437 csk ECDSAP256SHA256 256 bits\nSoonest signature expiry: 2026-11-28 (in 14 days)\nns1.example.com: ok, serial 2026111401, TCP yes\nns2.example.com: ok, serial 2026111401, TCP yes\n- info: Your zone uses NSEC3\n2 checks passed\nCredits: 2 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/report": {
      "get": {
        "tags": [
          "Domain and DNS"
        ],
        "summary": "Domain report",
        "description": "One graded report on a domain: DNS with DNSSEC and nameservers, registration, email setup, SSL and the website's HTTPS and security headers, each with its own grade, plus facts such as age and hosting. Costs 10 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 5 minutes; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_domain_report",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "A domain or URL to report on.",
              "examples": [
                "example.com"
              ],
              "title": "Domain"
            },
            "description": "A domain or URL to report on."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DomainReportResponse"
                },
                "example": {
                  "tool": "domain-report",
                  "target": "example.com",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 10,
                  "summary": "example.com gets an A. HSTS isn't set and your DMARC policy only monitors (p=none). DNS and registration look fine.",
                  "score": 91,
                  "findings": [
                    {
                      "id": "hsts.missing",
                      "severity": "fail",
                      "title": "HSTS isn't set",
                      "detail": "https://example.com/ sends no Strict-Transport-Security.",
                      "fix": "Send Strict-Transport-Security: max-age=31536000; includeSubDomains over HTTPS."
                    },
                    {
                      "id": "dmarc.policy_none",
                      "severity": "warn",
                      "title": "Your DMARC policy only monitors (p=none)",
                      "detail": "_dmarc.example.com says p=none.",
                      "fix": "Move to p=quarantine, then p=reject, once reports show your mail passes."
                    },
                    {
                      "id": "spf.softfail_all",
                      "severity": "warn",
                      "title": "Your SPF record ends in ~all",
                      "detail": "With p=none, ~all lets spoofed mail through.",
                      "fix": "Move to -all once DMARC reports show all your mail passes."
                    },
                    {
                      "id": "ssl.expires_soon",
                      "severity": "warn",
                      "title": "Your certificate expires within 30 days",
                      "detail": "The certificate on example.com and www.example.com expires on 26 November 2026.",
                      "fix": "Renew the certificate or check that automatic renewal is set up."
                    },
                    {
                      "id": "dns.no_caa",
                      "severity": "info",
                      "title": "Your domain has no CAA record",
                      "detail": "Any certificate authority may issue certificates for example.com.",
                      "fix": "Add a CAA record naming the certificate authorities you use, for example 0 issue \"letsencrypt.org\", so no other authority will issue certificates for your domain."
                    },
                    {
                      "id": "dnssec.unsigned",
                      "severity": "info",
                      "title": "Your domain isn't signed with DNSSEC",
                      "detail": "There is no DS record for example.com at the .com registry and no DNSKEY in the zone.",
                      "fix": "Turn on DNSSEC at your DNS provider, then add the DS record it gives you at your registrar."
                    },
                    {
                      "id": "ns.consistent",
                      "severity": "pass",
                      "title": "Your nameservers all answer and agree",
                      "detail": "2 nameservers, 2 addresses, serial 2026111401 everywhere.",
                      "fix": "Nothing to do."
                    },
                    {
                      "id": "mx.ok",
                      "severity": "pass",
                      "title": "Your mail servers are set up",
                      "detail": "1 MX host, smtp.google.com, resolves.",
                      "fix": "Nothing to do."
                    },
                    {
                      "id": "dkim.found",
                      "severity": "pass",
                      "title": "DKIM keys found",
                      "detail": "Selector google has a 2048-bit RSA key.",
                      "fix": "Nothing to do."
                    }
                  ],
                  "data": {
                    "name": "example.com",
                    "unicode": "example.com",
                    "registrable": "example.com",
                    "grade": "A",
                    "sections": {
                      "dns": {
                        "section": "dns",
                        "status": "ok",
                        "score": 100,
                        "grade": "A",
                        "summary": "example.com resolves to 1 IPv4 and 1 IPv6 address, receives mail through 1 MX host and isn't DNSSEC-signed. example.com isn't signed with DNSSEC. Both of its nameservers answer and agree.",
                        "checks": [
                          {
                            "tool": "dns-lookup",
                            "status": "ok",
                            "cached": false,
                            "fetched_at": "2026-11-14T10:00:00Z",
                            "summary": "example.com resolves to 1 IPv4 and 1 IPv6 address, receives mail through 1 MX host and isn't DNSSEC-signed.",
                            "findings": [
                              {
                                "id": "dns.no_caa",
                                "severity": "info",
                                "title": "Your domain has no CAA record",
                                "detail": "Any certificate authority may issue certificates for example.com.",
                                "fix": "Add a CAA record naming the certificate authorities you use, for example 0 issue \"letsencrypt.org\", so no other authority will issue certificates for your domain."
                              }
                            ],
                            "data": {
                              "name": "example.com",
                              "unicode": "example.com",
                              "nxdomain": false,
                              "dnssec": "insecure",
                              "wildcard": false,
                              "records": {
                                "A": [
                                  {
                                    "name": "example.com",
                                    "ttl": 300,
                                    "value": "192.0.2.10"
                                  }
                                ],
                                "AAAA": [
                                  {
                                    "name": "example.com",
                                    "ttl": 300,
                                    "value": "2001:db8::10"
                                  }
                                ],
                                "CNAME": [],
                                "MX": [
                                  {
                                    "name": "example.com",
                                    "ttl": 3600,
                                    "value": "1 smtp.google.com"
                                  }
                                ],
                                "NS": [
                                  {
                                    "name": "example.com",
                                    "ttl": 86400,
                                    "value": "anna.ns.cloudflare.com"
                                  },
                                  {
                                    "name": "example.com",
                                    "ttl": 86400,
                                    "value": "bob.ns.cloudflare.com"
                                  }
                                ],
                                "TXT": [
                                  {
                                    "name": "example.com",
                                    "ttl": 3600,
                                    "value": "v=spf1 include:_spf.google.com ~all"
                                  }
                                ],
                                "SOA": [
                                  {
                                    "name": "example.com",
                                    "ttl": 3600,
                                    "value": "anna.ns.cloudflare.com dns.cloudflare.com 2026111401 10000 2400 604800 1800"
                                  }
                                ],
                                "CAA": []
                              },
                              "query_status": {
                                "A": "ok",
                                "AAAA": "ok",
                                "CNAME": "nodata",
                                "MX": "ok",
                                "NS": "ok",
                                "TXT": "ok",
                                "SOA": "ok",
                                "CAA": "nodata"
                              },
                              "cname_chain": [],
                              "hosts": {
                                "smtp.google.com": {
                                  "A": [
                                    "192.0.2.25"
                                  ],
                                  "AAAA": [],
                                  "roles": [
                                    "MX"
                                  ],
                                  "status": "ok"
                                },
                                "anna.ns.cloudflare.com": {
                                  "A": [
                                    "198.51.100.1"
                                  ],
                                  "AAAA": [],
                                  "roles": [
                                    "NS"
                                  ],
                                  "status": "ok"
                                },
                                "bob.ns.cloudflare.com": {
                                  "A": [
                                    "198.51.100.2"
                                  ],
                                  "AAAA": [],
                                  "roles": [
                                    "NS"
                                  ],
                                  "status": "ok"
                                }
                              },
                              "min_ttl": 300
                            }
                          },
                          {
                            "tool": "dnssec-checker",
                            "status": "ok",
                            "cached": false,
                            "fetched_at": "2026-11-14T10:00:00Z",
                            "summary": "example.com isn't signed with DNSSEC. Both of its nameservers answer and agree.",
                            "findings": [
                              {
                                "id": "dnssec.unsigned",
                                "severity": "info",
                                "title": "Your domain isn't signed with DNSSEC",
                                "detail": "There is no DS record for example.com at the .com registry and no DNSKEY in the zone.",
                                "fix": "Turn on DNSSEC at your DNS provider, then add the DS record it gives you at your registrar."
                              },
                              {
                                "id": "ns.consistent",
                                "severity": "pass",
                                "title": "Your nameservers all answer and agree",
                                "detail": "2 nameservers, 2 addresses, serial 2026111401 everywhere.",
                                "fix": "Nothing to do."
                              }
                            ],
                            "data": {
                              "name": "example.com",
                              "unicode": "example.com",
                              "zone": "example.com",
                              "parent": "com",
                              "dnssec": "insecure",
                              "extended_errors": [],
                              "chain": [
                                {
                                  "zone": "com",
                                  "signed": true,
                                  "secure": true
                                },
                                {
                                  "zone": "example.com",
                                  "signed": false,
                                  "secure": false
                                }
                              ],
                              "ds": [],
                              "dnskeys": [],
                              "signatures": [],
                              "parent_ns": [
                                "anna.ns.cloudflare.com",
                                "bob.ns.cloudflare.com"
                              ],
                              "parent_ns_ttl": 172800,
                              "child_ns": [
                                "anna.ns.cloudflare.com",
                                "bob.ns.cloudflare.com"
                              ],
                              "nameservers": [
                                {
                                  "name": "anna.ns.cloudflare.com",
                                  "in_parent": true,
                                  "in_child": true,
                                  "glue": [],
                                  "addresses": [
                                    "198.51.100.1"
                                  ],
                                  "status": "ok",
                                  "servers": []
                                },
                                {
                                  "name": "bob.ns.cloudflare.com",
                                  "in_parent": true,
                                  "in_child": true,
                                  "glue": [],
                                  "addresses": [
                                    "198.51.100.2"
                                  ],
                                  "status": "ok",
                                  "servers": []
                                }
                              ],
                              "serials": {
                                "2026111401": [
                                  "198.51.100.1",
                                  "198.51.100.2"
                                ]
                              },
                              "ipv6_checked": false,
                              "min_ttl": 300
                            }
                          }
                        ]
                      },
                      "registration": {
                        "section": "registration",
                        "status": "ok",
                        "score": 100,
                        "grade": "A",
                        "summary": "example.com is registered with Example Registrar, Inc. until 13 August 2027 (in 272 days). Transfers are locked.",
                        "checks": [
                          {
                            "tool": "whois-lookup",
                            "status": "ok",
                            "cached": false,
                            "fetched_at": "2026-11-14T10:00:00Z",
                            "summary": "example.com is registered with Example Registrar, Inc. until 13 August 2027 (in 272 days). Transfers are locked.",
                            "findings": [],
                            "data": {
                              "name": "example.com",
                              "unicode": "example.com",
                              "tld": "com",
                              "tier": "A",
                              "source": "rdap",
                              "registered": true,
                              "registrar": {
                                "name": "Example Registrar, Inc.",
                                "iana_id": "9999",
                                "url": "https://registrar.example.net",
                                "abuse_email": "abuse@registrar.example.net"
                              },
                              "created": "1995-08-14T04:00:00Z",
                              "updated": "2026-08-14T07:01:34Z",
                              "expires": "2027-08-13T04:00:00Z",
                              "age_days": 11415,
                              "days_to_expiry": 272,
                              "statuses": [
                                "clientDeleteProhibited",
                                "clientTransferProhibited",
                                "clientUpdateProhibited"
                              ],
                              "nameservers": [
                                "anna.ns.cloudflare.com",
                                "bob.ns.cloudflare.com"
                              ],
                              "dnssec": false,
                              "redacted_fields": [
                                "registrant",
                                "admin",
                                "tech"
                              ],
                              "unpublished_fields": []
                            }
                          }
                        ]
                      },
                      "email": {
                        "section": "email",
                        "status": "ok",
                        "score": 87,
                        "grade": "B",
                        "summary": "example.com receives mail through Google Workspace and signs it with DKIM. Its DMARC policy only monitors, so spoofed mail isn't blocked yet.",
                        "checks": [
                          {
                            "tool": "email-checker",
                            "status": "ok",
                            "cached": false,
                            "fetched_at": "2026-11-14T10:00:00Z",
                            "summary": "example.com receives mail through Google Workspace and signs it with DKIM. Its DMARC policy only monitors, so spoofed mail isn't blocked yet.",
                            "score": 87,
                            "findings": [
                              {
                                "id": "dmarc.policy_none",
                                "severity": "warn",
                                "title": "Your DMARC policy only monitors (p=none)",
                                "detail": "_dmarc.example.com says p=none.",
                                "fix": "Move to p=quarantine, then p=reject, once reports show your mail passes."
                              },
                              {
                                "id": "spf.softfail_all",
                                "severity": "warn",
                                "title": "Your SPF record ends in ~all",
                                "detail": "With p=none, ~all lets spoofed mail through.",
                                "fix": "Move to -all once DMARC reports show all your mail passes."
                              },
                              {
                                "id": "mx.ok",
                                "severity": "pass",
                                "title": "Your mail servers are set up",
                                "detail": "1 MX host, smtp.google.com, resolves.",
                                "fix": "Nothing to do."
                              },
                              {
                                "id": "dkim.found",
                                "severity": "pass",
                                "title": "DKIM keys found",
                                "detail": "Selector google has a 2048-bit RSA key.",
                                "fix": "Nothing to do."
                              }
                            ],
                            "data": {
                              "name": "example.com",
                              "unicode": "example.com",
                              "nxdomain": false,
                              "providers": [
                                {
                                  "id": "google-workspace",
                                  "name": "Google Workspace",
                                  "source": "mx"
                                }
                              ],
                              "mx": {
                                "status": "ok",
                                "null_mx": false,
                                "implicit": false,
                                "records": [
                                  {
                                    "preference": 1,
                                    "host": "smtp.google.com",
                                    "ttl": 3600,
                                    "is_ip": false,
                                    "A": [
                                      "192.0.2.25"
                                    ],
                                    "AAAA": [],
                                    "status": "ok",
                                    "provider": "google-workspace"
                                  }
                                ]
                              },
                              "spf": {
                                "status": "found",
                                "record": "v=spf1 include:_spf.google.com ~all",
                                "records": [
                                  "v=spf1 include:_spf.google.com ~all"
                                ],
                                "all": "~all",
                                "lookups": 4,
                                "lookup_limit": 10,
                                "void_lookups": 0,
                                "capped": false
                              },
                              "dmarc": {
                                "status": "found",
                                "name": "_dmarc.example.com",
                                "source": "exact",
                                "record": "v=DMARC1; p=none; rua=mailto:dmarc@example.com",
                                "policy": "none",
                                "effective_policy": "none",
                                "pct": 100,
                                "adkim": "r",
                                "aspf": "r",
                                "reports": [
                                  {
                                    "kind": "rua",
                                    "uri": "mailto:dmarc@example.com",
                                    "domain": "example.com",
                                    "external": false
                                  }
                                ]
                              },
                              "dkim": {
                                "selectors_tried": [
                                  "google",
                                  "default",
                                  "selector1",
                                  "selector2"
                                ],
                                "failed": [],
                                "found": [
                                  {
                                    "selector": "google",
                                    "name": "google._domainkey.example.com",
                                    "status": "ok",
                                    "key_type": "rsa",
                                    "key_bits": 2048,
                                    "testing": false,
                                    "provider": "google-workspace",
                                    "record": "v=DKIM1; k=rsa; p=MIIBIjANBgkqh..."
                                  }
                                ]
                              },
                              "policies": {
                                "mta_sts": {
                                  "present": false
                                },
                                "tls_rpt": {
                                  "present": false
                                },
                                "bimi": {
                                  "present": false
                                }
                              },
                              "min_ttl": 300
                            }
                          }
                        ]
                      },
                      "ssl": {
                        "section": "ssl",
                        "status": "ok",
                        "score": 90,
                        "grade": "A",
                        "summary": "example.com's certificate is trusted and valid for 12 more days, covering example.com and www.example.com. The server offers TLS 1.3.",
                        "checks": [
                          {
                            "tool": "ssl-checker",
                            "status": "ok",
                            "cached": false,
                            "fetched_at": "2026-11-14T10:00:00Z",
                            "summary": "example.com's certificate is trusted and valid for 12 more days, covering example.com and www.example.com. The server offers TLS 1.3.",
                            "score": 90,
                            "findings": [
                              {
                                "id": "ssl.expires_soon",
                                "severity": "warn",
                                "title": "Your certificate expires within 30 days",
                                "detail": "The certificate on example.com and www.example.com expires on 26 November 2026.",
                                "fix": "Renew the certificate or check that automatic renewal is set up."
                              }
                            ],
                            "data": {
                              "name": "example.com",
                              "unicode": "example.com",
                              "hosts": [
                                {
                                  "host": "example.com",
                                  "status": "ok",
                                  "address": "192.0.2.10",
                                  "tls": {
                                    "version": "TLSv1.3",
                                    "cipher": "TLS_AES_128_GCM_SHA256",
                                    "forward_secrecy": true,
                                    "alpn": "h2",
                                    "versions": {
                                      "TLSv1.3": true,
                                      "TLSv1.2": true
                                    },
                                    "non_forward_secret": false,
                                    "ocsp_stapled": false
                                  },
                                  "certificate": {
                                    "subject": "CN=example.com",
                                    "common_name": "example.com",
                                    "names": [
                                      "example.com",
                                      "www.example.com"
                                    ],
                                    "issuer": "CN=R11,O=Let's Encrypt,C=US",
                                    "issuer_org": "Let's Encrypt",
                                    "caa_identifiers": [
                                      "letsencrypt.org"
                                    ],
                                    "serial": "04a1",
                                    "not_before": "2026-08-28T00:00:00Z",
                                    "not_after": "2026-11-26T23:59:59Z",
                                    "days_left": 12,
                                    "key": {
                                      "type": "EC",
                                      "size": 256,
                                      "curve": "secp256r1"
                                    },
                                    "signature_algorithm": "sha256WithRSAEncryption",
                                    "sha256": "ab12",
                                    "scts": 2
                                  },
                                  "chain": [],
                                  "trust": {
                                    "trusted": true,
                                    "hostname_match": true,
                                    "root": "ISRG Root X1",
                                    "path": [
                                      "example.com",
                                      "R11",
                                      "ISRG Root X1"
                                    ]
                                  }
                                },
                                {
                                  "host": "www.example.com",
                                  "status": "ok",
                                  "address": "192.0.2.10",
                                  "chain": [],
                                  "trust": {
                                    "trusted": true,
                                    "hostname_match": true,
                                    "root": "ISRG Root X1",
                                    "path": []
                                  }
                                }
                              ],
                              "trust_store": {
                                "source": "certifi",
                                "version": "2026.10.5"
                              },
                              "legacy_versions_tested": true
                            }
                          }
                        ]
                      },
                      "website": {
                        "section": "website",
                        "status": "ok",
                        "score": 80,
                        "grade": "B",
                        "summary": "example.com gets a B for its HTTP headers. HSTS is missing.",
                        "checks": [
                          {
                            "tool": "security-headers",
                            "status": "ok",
                            "cached": false,
                            "fetched_at": "2026-11-14T10:00:00Z",
                            "summary": "example.com gets a B for its HTTP headers. HSTS is missing.",
                            "score": 80,
                            "findings": [
                              {
                                "id": "hsts.missing",
                                "severity": "fail",
                                "title": "HSTS isn't set",
                                "detail": "https://example.com/ sends no Strict-Transport-Security.",
                                "fix": "Send Strict-Transport-Security: max-age=31536000; includeSubDomains over HTTPS."
                              }
                            ],
                            "data": {
                              "host": "example.com",
                              "alternate_host": "www.example.com",
                              "reachable": true,
                              "no_website": false,
                              "entry_points": []
                            }
                          }
                        ]
                      }
                    },
                    "facts": {
                      "domain_age_days": 11415,
                      "created": "1995-08-14T04:00:00Z",
                      "expires": "2027-08-13T04:00:00Z",
                      "days_to_expiry": 272,
                      "registrar": "Example Registrar, Inc.",
                      "dns_host": {
                        "id": "cloudflare",
                        "name": "Cloudflare",
                        "source": "ns"
                      },
                      "mail_provider": {
                        "id": "google-workspace",
                        "name": "Google Workspace",
                        "source": "mx"
                      },
                      "web_host": {
                        "id": "vercel",
                        "name": "Vercel",
                        "source": "cname"
                      },
                      "addresses": [
                        "192.0.2.10",
                        "2001:db8::10"
                      ],
                      "network": {
                        "asn": 64496,
                        "name": "EXAMPLE-NET",
                        "country": "NL"
                      }
                    },
                    "section_order": [
                      "dns",
                      "registration",
                      "email",
                      "facts",
                      "website",
                      "ssl"
                    ]
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "x-dnssuper-tool": "domain-report",
        "x-dnssuper-price": "Costs 10 credits per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for up to 5 minutes; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "domain_report",
          "example": "example.com gets an A. HSTS isn't set and your DMARC policy only monitors (p=none). DNS and registration look fine.\nScore: 91/100\nGrade: A\nDNS: A. example.com resolves to 1 IPv4 and 1 IPv6 address, receives mail through 1 MX host and isn't DNSSEC-signed.\nRegistration: A. example.com is registered with Example Registrar, Inc. until 13 August 2027 (in 272 days).\nEmail: B. example.com receives mail through Google Workspace and signs it with DKIM.\nSSL: A. example.com's certificate is trusted and valid for 12 more days, covering example.com and www.example.com.\nWebsite: B. example.com gets a B for its HTTP headers.\nFacts: registered 1995-08-14 (11415 days ago); expires 2027-08-13 (in 272 days); registrar Example Registrar, Inc.; DNS Cloudflare; mail Google Workspace; web Vercel; addresses 192.0.2.10, 2001:db8...\n- fail: HSTS isn't set. Fix: Send Strict-Transport-Security: max-age=31536000; includeSubDomains over HTTPS.\n- warn: Your DMARC policy only monitors (p=none). Fix: Move to p=quarantine, then p=reject, once reports show your mail passes.\n- warn: Your SPF record ends in ~all. Fix: Move to -all once DMARC reports show all your mail passes.\n- warn: Your certificate expires within 30 days. Fix: Renew the certificate or check that automatic renewal is set up.\n+2 more findings (pass detail='full' to see all)\n3 checks passed\nCredits: 10 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/build/spf": {
      "post": {
        "tags": [
          "Domain and DNS"
        ],
        "summary": "SPF builder",
        "description": "An SPF record built from your senders, or a pasted record checked, with its DNS lookup count and the include tree. Free; any API key works and nothing is charged. Never cached; every call runs again.",
        "operationId": "run_spf_generator",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SpfGeneratorParams"
              },
              "example": {
                "providers": [
                  "google-workspace",
                  "sendgrid"
                ],
                "mx": true,
                "all": "~all",
                "domain": "example.com"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SpfGeneratorResponse"
                },
                "example": {
                  "tool": "spf-generator",
                  "target": "",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 0,
                  "summary": "Your SPF record is ready to publish as a TXT record. It needs 6 of the 10 DNS lookups receivers allow.",
                  "findings": [
                    {
                      "id": "spf_builder.softfail",
                      "severity": "info",
                      "title": "This record ends in ~all",
                      "detail": "",
                      "fix": "Move to -all once DMARC reports show all your mail passes."
                    }
                  ],
                  "data": {
                    "kind": "spf",
                    "name": "example.com",
                    "type": "TXT",
                    "value": "v=spf1 mx include:_spf.google.com include:sendgrid.net ~all",
                    "strings": [
                      "v=spf1 mx include:_spf.google.com include:sendgrid.net ~all"
                    ],
                    "length": 59,
                    "zone_line": "example.com. 3600 IN TXT \"v=spf1 mx include:_spf.google.com include:sendgrid.net ~all\"",
                    "mode": "build",
                    "spf": {
                      "lookups": 6,
                      "lookup_limit": 10,
                      "void_lookups": 0,
                      "capped": false,
                      "tree": {
                        "domain": "example.com",
                        "status": "given",
                        "record": "v=spf1 mx include:_spf.google.com include:sendgrid.net ~all",
                        "errors": [],
                        "terms": [
                          {
                            "term": "mx",
                            "mechanism": "mx",
                            "qualifier": "+",
                            "target": "example.com",
                            "counted": true,
                            "status": "ok",
                            "addresses": [
                              "93.184.215.20"
                            ],
                            "hosts": [
                              "mx1.example.com"
                            ],
                            "detail": ""
                          },
                          {
                            "term": "include:_spf.google.com",
                            "mechanism": "include",
                            "qualifier": "+",
                            "target": "_spf.google.com",
                            "counted": true,
                            "status": "ok",
                            "addresses": [],
                            "hosts": [],
                            "detail": "",
                            "child": {
                              "domain": "_spf.google.com",
                              "status": "found",
                              "record": "v=spf1 include:_netblocks.google.com include:_netblocks2.google.com include:_netblocks3.google.com ~all",
                              "errors": [],
                              "terms": [
                                {
                                  "term": "include:_netblocks.google.com",
                                  "mechanism": "include",
                                  "qualifier": "+",
                                  "target": "_netblocks.google.com",
                                  "counted": true,
                                  "status": "ok",
                                  "addresses": [],
                                  "hosts": [],
                                  "detail": "",
                                  "child": {
                                    "domain": "_netblocks.google.com",
                                    "status": "found",
                                    "record": "v=spf1 ip4:35.190.247.0/24 ip4:64.233.160.0/19 ip4:66.102.0.0/20 ip4:66.249.80.0/20 ip4:72.14.192.0/18 ~all",
                                    "errors": [],
                                    "terms": [
                                      {
                                        "term": "ip4:35.190.247.0/24",
                                        "mechanism": "ip4",
                                        "qualifier": "+",
                                        "target": "35.190.247.0",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "ip4:64.233.160.0/19",
                                        "mechanism": "ip4",
                                        "qualifier": "+",
                                        "target": "64.233.160.0",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "ip4:66.102.0.0/20",
                                        "mechanism": "ip4",
                                        "qualifier": "+",
                                        "target": "66.102.0.0",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "ip4:66.249.80.0/20",
                                        "mechanism": "ip4",
                                        "qualifier": "+",
                                        "target": "66.249.80.0",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "ip4:72.14.192.0/18",
                                        "mechanism": "ip4",
                                        "qualifier": "+",
                                        "target": "72.14.192.0",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "~all",
                                        "mechanism": "all",
                                        "qualifier": "~",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      }
                                    ]
                                  }
                                },
                                {
                                  "term": "include:_netblocks2.google.com",
                                  "mechanism": "include",
                                  "qualifier": "+",
                                  "target": "_netblocks2.google.com",
                                  "counted": true,
                                  "status": "ok",
                                  "addresses": [],
                                  "hosts": [],
                                  "detail": "",
                                  "child": {
                                    "domain": "_netblocks2.google.com",
                                    "status": "found",
                                    "record": "v=spf1 ip6:2001:4860:4000::/36 ip6:2404:6800:4000::/36 ip6:2607:f8b0:4000::/36 ~all",
                                    "errors": [],
                                    "terms": [
                                      {
                                        "term": "ip6:2001:4860:4000::/36",
                                        "mechanism": "ip6",
                                        "qualifier": "+",
                                        "target": "2001:4860:4000::",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "ip6:2404:6800:4000::/36",
                                        "mechanism": "ip6",
                                        "qualifier": "+",
                                        "target": "2404:6800:4000::",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "ip6:2607:f8b0:4000::/36",
                                        "mechanism": "ip6",
                                        "qualifier": "+",
                                        "target": "2607:f8b0:4000::",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "~all",
                                        "mechanism": "all",
                                        "qualifier": "~",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      }
                                    ]
                                  }
                                },
                                {
                                  "term": "include:_netblocks3.google.com",
                                  "mechanism": "include",
                                  "qualifier": "+",
                                  "target": "_netblocks3.google.com",
                                  "counted": true,
                                  "status": "ok",
                                  "addresses": [],
                                  "hosts": [],
                                  "detail": "",
                                  "child": {
                                    "domain": "_netblocks3.google.com",
                                    "status": "found",
                                    "record": "v=spf1 ip4:172.217.0.0/19 ip4:172.217.32.0/20 ip4:108.177.96.0/19 ~all",
                                    "errors": [],
                                    "terms": [
                                      {
                                        "term": "ip4:172.217.0.0/19",
                                        "mechanism": "ip4",
                                        "qualifier": "+",
                                        "target": "172.217.0.0",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "ip4:172.217.32.0/20",
                                        "mechanism": "ip4",
                                        "qualifier": "+",
                                        "target": "172.217.32.0",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "ip4:108.177.96.0/19",
                                        "mechanism": "ip4",
                                        "qualifier": "+",
                                        "target": "108.177.96.0",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "~all",
                                        "mechanism": "all",
                                        "qualifier": "~",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      }
                                    ]
                                  }
                                },
                                {
                                  "term": "~all",
                                  "mechanism": "all",
                                  "qualifier": "~",
                                  "counted": false,
                                  "status": "ok",
                                  "addresses": [],
                                  "hosts": [],
                                  "detail": ""
                                }
                              ]
                            }
                          },
                          {
                            "term": "include:sendgrid.net",
                            "mechanism": "include",
                            "qualifier": "+",
                            "target": "sendgrid.net",
                            "counted": true,
                            "status": "ok",
                            "addresses": [],
                            "hosts": [],
                            "detail": "",
                            "child": {
                              "domain": "sendgrid.net",
                              "status": "found",
                              "record": "v=spf1 ip4:167.89.0.0/17 ip4:208.117.48.0/20 ~all",
                              "errors": [],
                              "terms": [
                                {
                                  "term": "ip4:167.89.0.0/17",
                                  "mechanism": "ip4",
                                  "qualifier": "+",
                                  "target": "167.89.0.0",
                                  "counted": false,
                                  "status": "ok",
                                  "addresses": [],
                                  "hosts": [],
                                  "detail": ""
                                },
                                {
                                  "term": "ip4:208.117.48.0/20",
                                  "mechanism": "ip4",
                                  "qualifier": "+",
                                  "target": "208.117.48.0",
                                  "counted": false,
                                  "status": "ok",
                                  "addresses": [],
                                  "hosts": [],
                                  "detail": ""
                                },
                                {
                                  "term": "~all",
                                  "mechanism": "all",
                                  "qualifier": "~",
                                  "counted": false,
                                  "status": "ok",
                                  "addresses": [],
                                  "hosts": [],
                                  "detail": ""
                                }
                              ]
                            }
                          },
                          {
                            "term": "~all",
                            "mechanism": "all",
                            "qualifier": "~",
                            "counted": false,
                            "status": "ok",
                            "addresses": [],
                            "hosts": [],
                            "detail": ""
                          }
                        ]
                      },
                      "flattening": {
                        "needed": false,
                        "advice": ""
                      }
                    }
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ],
        "x-dnssuper-tool": "spf-generator",
        "x-dnssuper-price": "Free; any API key works and nothing is charged.",
        "x-dnssuper-cache": "Never cached; every call runs again.",
        "x-dnssuper-mcp": {
          "tool": "build_dns_record",
          "example": "Your SPF record is ready to publish as a TXT record. It needs 6 of the 10 DNS lookups receivers allow.\nName: example.com (TXT)\nValue: v=spf1 mx include:_spf.google.com include:sendgrid.net ~all\nLookups: 6 of 10\nZone line: example.com. 3600 IN TXT \"v=spf1 mx include:_spf.google.com include:sendgrid.net ~all\"\n- info: This record ends in ~all\nFree | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/build/dmarc": {
      "post": {
        "tags": [
          "Domain and DNS"
        ],
        "summary": "DMARC builder",
        "description": "A DMARC record built from your choices, with a rollout plan and the authorization records external report addresses need. Free; any API key works and nothing is charged. Never cached; every call runs again.",
        "operationId": "run_dmarc_generator",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DmarcGeneratorParams"
              },
              "example": {
                "domain": "example.com",
                "policy": "quarantine",
                "rua": [
                  "dmarc@example.com",
                  "agg@reports.example.net"
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DmarcGeneratorResponse"
                },
                "example": {
                  "tool": "dmarc-generator",
                  "target": "",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 0,
                  "summary": "Your DMARC record is ready: publish it as a TXT record at _dmarc.example.com. The report domains it names must publish the authorization records listed.",
                  "findings": [
                    {
                      "id": "dmarc_builder.external_reports",
                      "severity": "info",
                      "title": "Reports go to another domain",
                      "detail": "reports.example.net",
                      "fix": "That domain must publish an authorization record; the result lists it."
                    }
                  ],
                  "data": {
                    "kind": "dmarc",
                    "name": "_dmarc.example.com",
                    "type": "TXT",
                    "value": "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com,mailto:agg@reports.example.net",
                    "strings": [
                      "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com,mailto:agg@reports.example.net"
                    ],
                    "length": 83,
                    "zone_line": "_dmarc.example.com. 3600 IN TXT \"v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com,mailto:agg@reports.example.net\"",
                    "mode": "build",
                    "dmarc": {
                      "rollout": [
                        {
                          "stage": 1,
                          "policy": "none",
                          "value": "v=DMARC1; p=none; rua=mailto:dmarc@example.com,mailto:agg@reports.example.net",
                          "when": "Now: collect reports for two to four weeks and fix any sender that fails."
                        },
                        {
                          "stage": 2,
                          "policy": "quarantine",
                          "value": "v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com,mailto:agg@reports.example.net",
                          "when": "When reports show all your own mail passes."
                        },
                        {
                          "stage": 3,
                          "policy": "reject",
                          "value": "v=DMARC1; p=reject; rua=mailto:dmarc@example.com,mailto:agg@reports.example.net",
                          "when": "After a few weeks on quarantine without surprises."
                        }
                      ],
                      "report_authorizations": [
                        {
                          "domain": "reports.example.net",
                          "name": "example.com._report._dmarc.reports.example.net",
                          "value": "v=DMARC1"
                        }
                      ]
                    }
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ],
        "x-dnssuper-tool": "dmarc-generator",
        "x-dnssuper-price": "Free; any API key works and nothing is charged.",
        "x-dnssuper-cache": "Never cached; every call runs again.",
        "x-dnssuper-mcp": {
          "tool": "build_dns_record",
          "example": "Your DMARC record is ready: publish it as a TXT record at _dmarc.example.com. The report domains it names must publish the authorization records listed.\nName: _dmarc.example.com (TXT)\nValue: v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com,mailto:agg@reports.example.net\nZone line: _dmarc.example.com. 3600 IN TXT \"v=DMARC1; p=quarantine; rua=mailto:dmarc@example.com,mailto:agg@reports.example.net\"\nAuthorization needed: example.com._report._dmarc.reports.example.net TXT \"v=DMARC1\"\n- info: Reports go to another domain\nFree | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/build/caa": {
      "post": {
        "tags": [
          "Domain and DNS"
        ],
        "summary": "CAA builder",
        "description": "CAA records built from the certificate authorities you choose, as zone file lines. Free; any API key works and nothing is charged. Never cached; every call runs again.",
        "operationId": "run_caa_generator",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CaaGeneratorParams"
              },
              "example": {
                "domain": "example.com",
                "issue": [
                  "letsencrypt",
                  "google-trust-services"
                ],
                "iodef": "security@example.com"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CaaGeneratorResponse"
                },
                "example": {
                  "tool": "caa-generator",
                  "target": "",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 0,
                  "summary": "These 3 CAA records for example.com are ready to publish.",
                  "findings": [],
                  "data": {
                    "kind": "caa",
                    "name": "example.com",
                    "type": "CAA",
                    "value": "0 issue \"letsencrypt.org\"\n0 issue \"pki.goog\"\n0 iodef \"mailto:security@example.com\"",
                    "strings": [
                      "0 issue \"letsencrypt.org\"",
                      "0 issue \"pki.goog\"",
                      "0 iodef \"mailto:security@example.com\""
                    ],
                    "length": 82,
                    "zone_line": "example.com. 3600 IN CAA 0 issue \"letsencrypt.org\"\nexample.com. 3600 IN CAA 0 issue \"pki.goog\"\nexample.com. 3600 IN CAA 0 iodef \"mailto:security@example.com\"",
                    "mode": "build",
                    "caa": {
                      "records": [
                        {
                          "flags": 0,
                          "tag": "issue",
                          "value": "letsencrypt.org",
                          "presentation": "0 issue \"letsencrypt.org\""
                        },
                        {
                          "flags": 0,
                          "tag": "issue",
                          "value": "pki.goog",
                          "presentation": "0 issue \"pki.goog\""
                        },
                        {
                          "flags": 0,
                          "tag": "iodef",
                          "value": "mailto:security@example.com",
                          "presentation": "0 iodef \"mailto:security@example.com\""
                        }
                      ],
                      "zone_lines": [
                        "example.com. 3600 IN CAA 0 issue \"letsencrypt.org\"",
                        "example.com. 3600 IN CAA 0 issue \"pki.goog\"",
                        "example.com. 3600 IN CAA 0 iodef \"mailto:security@example.com\""
                      ]
                    }
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ],
        "x-dnssuper-tool": "caa-generator",
        "x-dnssuper-price": "Free; any API key works and nothing is charged.",
        "x-dnssuper-cache": "Never cached; every call runs again.",
        "x-dnssuper-mcp": {
          "tool": "build_dns_record",
          "example": "These 3 CAA records for example.com are ready to publish.\nName: example.com (CAA)\nZone line: example.com. 3600 IN CAA 0 issue \"letsencrypt.org\"\nZone line: example.com. 3600 IN CAA 0 issue \"pki.goog\"\nZone line: example.com. 3600 IN CAA 0 iodef \"mailto:security@example.com\"\nNo issues found.\nFree | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/dkim-record": {
      "post": {
        "tags": [
          "Domain and DNS"
        ],
        "summary": "DKIM record validator",
        "description": "A DKIM record, pasted or looked up by selector, parsed into its key type, key size, flags and hash algorithms. Free; any API key works and nothing is charged. Never cached; every call runs again.",
        "operationId": "run_dkim_checker",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DkimCheckerParams"
              },
              "example": {
                "domain": "example.com",
                "selector": "s2048"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DkimCheckerResponse"
                },
                "example": {
                  "tool": "dkim-checker",
                  "target": "",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 0,
                  "summary": "The DKIM record at s2048._domainkey.example.com is valid (a 2048-bit RSA key).",
                  "findings": [
                    {
                      "id": "dkim_record.valid",
                      "severity": "pass",
                      "title": "The DKIM record is valid",
                      "detail": "",
                      "fix": "Nothing to do."
                    }
                  ],
                  "data": {
                    "source": "dns",
                    "name": "s2048._domainkey.example.com",
                    "record": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEApTGFY+knX9gV8lx+vLMRL+4h2Vef2XWTq1+IUtMY/ZRRoGQG31IR2Yz+FkzYaolUU2JMq2NbUzELco8z3Ef/iPmN4wITl7/cTQnwbn15fwvgeP59ICpyWpGtr/aq83ISRBjKEfTlRub1tRG/VVps0QaD4GjVBMGVPLYKKvlT9gG2Bzd86bLTkPOJcVHhjzqytVoqVW09guYc9W6J2XDfTES0ocQ7/p4zDR6/wmR4su5wwcy8C5GpeyKNERmR6w9DvH0c1ySrjtpvBMjDu4LTT4ruHJCHLqbWA1M31nFAi30vasgB0q6JZcEcOyM1ByetpiuqLfWNTLBm+RWQe4BguQIDAQAB",
                    "query_status": "ok",
                    "version": "DKIM1",
                    "key_type": "rsa",
                    "key_bits": 2048,
                    "revoked": false,
                    "testing": false,
                    "strict": false,
                    "service_types": [
                      "*"
                    ]
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ],
        "x-dnssuper-tool": "dkim-checker",
        "x-dnssuper-price": "Free; any API key works and nothing is charged.",
        "x-dnssuper-cache": "Never cached; every call runs again.",
        "x-dnssuper-mcp": {
          "tool": "validate_dkim_record",
          "example": "The DKIM record at s2048._domainkey.example.com is valid (a 2048-bit RSA key).\nLooked up: s2048._domainkey.example.com\nKey: 2048-bit RSA\n1 check passed\nFree | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/idn": {
      "get": {
        "tags": [
          "Domain and DNS"
        ],
        "summary": "IDN and punycode",
        "description": "A domain converted between Unicode and punycode, label by label, with the scripts used, lookalike warnings and how browsers will likely show it. Free; any API key works and nothing is charged. Never cached; every call runs again.",
        "operationId": "run_punycode_converter",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "name",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 1024,
              "description": "A domain, label or URL, in Unicode or punycode.",
              "examples": [
                "bücher.example"
              ],
              "x-mono": true,
              "title": "Name"
            },
            "description": "A domain, label or URL, in Unicode or punycode."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PunycodeConverterResponse"
                },
                "example": {
                  "tool": "punycode-converter",
                  "target": "",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 0,
                  "summary": "bücher.example in punycode is xn--bcher-kva.example.",
                  "findings": [],
                  "data": {
                    "input": "bücher.example",
                    "direction": "to_ascii",
                    "ascii": "xn--bcher-kva.example",
                    "unicode": "bücher.example",
                    "valid": true,
                    "labels": [
                      {
                        "unicode": "bücher",
                        "ascii": "xn--bcher-kva",
                        "valid": true,
                        "scripts": [
                          "Latin"
                        ],
                        "mixed_script": false,
                        "restriction": "single_script",
                        "chars": [
                          {
                            "char": "ü",
                            "codepoint": "U+00FC",
                            "name": "LATIN SMALL LETTER U WITH DIAERESIS",
                            "scripts": [
                              "Latin"
                            ],
                            "identifier": "allowed"
                          }
                        ],
                        "skeleton": "bücher",
                        "imitates_ascii": false
                      },
                      {
                        "unicode": "example",
                        "ascii": "example",
                        "valid": true,
                        "scripts": [
                          "Latin"
                        ],
                        "mixed_script": false,
                        "restriction": "ascii",
                        "chars": [],
                        "skeleton": "exarnple",
                        "imitates_ascii": false
                      }
                    ],
                    "skeleton": "bücher.exarnple",
                    "display": {
                      "likely": "unicode",
                      "reason": "Each label sticks to one writing system without lookalikes, so browsers will likely show it in Unicode."
                    }
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "punycode-converter",
        "x-dnssuper-price": "Free; any API key works and nothing is charged.",
        "x-dnssuper-cache": "Never cached; every call runs again.",
        "x-dnssuper-mcp": {
          "tool": "convert_idn",
          "example": "bücher.example in punycode is xn--bcher-kva.example.\nASCII: xn--bcher-kva.example\nUnicode: bücher.example\nLabel 1: Latin, single script, 1 non-ASCII character\nLabel 2: plain ASCII\nBrowsers will likely show: unicode (Each label sticks to one writing system without lookalikes, so browsers will likely show it in Unicode.)\nNo issues found.\nFree | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/migration": {
      "post": {
        "tags": [
          "Domain and DNS"
        ],
        "summary": "Migration checker",
        "description": "Record by record, how the new nameservers' answers compare with the current ones before you switch, with DNSSEC and TTL advice. Costs 5 credits, reserved when the job starts and charged when it finishes. Failed runs are free. Answers are cached for up to 1 minute; send fresh=true to ask the source again.",
        "operationId": "run_dns_migration_checker",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DnsMigrationCheckerParams"
              },
              "example": {
                "domain": "example.com",
                "new_nameservers": [
                  "ns1.new-dns.example.net",
                  "ns2.new-dns.example.net"
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobStartResponse"
                },
                "example": {
                  "job_id": "5ef1741e-8198-585b-8440-2b6634de62c9",
                  "status": "queued",
                  "total": 1,
                  "credits_reserved": 5,
                  "duplicates_removed": 0,
                  "job_url": "https://api.dnssuper.localhost/v1/jobs/5ef1741e-8198-585b-8440-2b6634de62c9",
                  "items_url": "https://api.dnssuper.localhost/v1/jobs/5ef1741e-8198-585b-8440-2b6634de62c9/items",
                  "events_url": "https://api.dnssuper.localhost/v1/jobs/5ef1741e-8198-585b-8440-2b6634de62c9/events"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ],
        "x-dnssuper-tool": "dns-migration-checker",
        "x-dnssuper-price": "Costs 5 credits, reserved when the job starts and charged when it finishes. Failed runs are free.",
        "x-dnssuper-cache": "Answers are cached for up to 1 minute; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "check_migration",
          "example": "example.com is ready to move: the new nameservers answer the same way for all 81 names we compared.\nReady: yes\nCurrent: ns1.old-dns.example.net (192.0.2.1), serial 2026111401\nNew: ns1.new-dns.example.net (198.51.100.1) (ok, serial 2026111401); ns2.new-dns.example.net (198.51.100.2) (ok, serial 2026111401)\nCompared: 81 names, 12 records: 12 same\n- info: We checked 81 names; DNS can't list the rest\n- info: Lower your TTLs before you switch\n1 check passed\nCredits: 5 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/dangling": {
      "post": {
        "tags": [
          "Domain and DNS"
        ],
        "summary": "Dangling record check",
        "description": "For each name, whether its CNAME, NS or address records point to a service, zone or domain that someone else could claim. Costs 1 credit per name; cached answers cost the same. Names that fail upstream are free. Answers are cached for the lowest record TTL, between 1 minute and 1 hour; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_subdomain_takeover_check",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SubdomainTakeoverCheckParams"
              },
              "example": {
                "names": [
                  "shop.example.com"
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The result",
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BatchResponse"
                },
                "example": {
                  "tool": "subdomain-takeover-check",
                  "target": "shop.example.com",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 1,
                  "summary": "shop.example.com looks like it could be taken over: GitHub Pages says it has no site for this name.",
                  "findings": [
                    {
                      "id": "dangling.service_unclaimed",
                      "severity": "fail",
                      "title": "This name points to a service where it looks unclaimed",
                      "detail": "shop.example.com points to GitHub Pages, and its page says \"There isn't a GitHub Pages site here.\" (HTTP 404). The name looks unclaimed at the service, so someone else could claim it.",
                      "fix": "Remove the DNS record now, or set the name up again in your account at that service."
                    }
                  ],
                  "data": {
                    "name": "shop.example.com",
                    "unicode": "shop.example.com",
                    "exists": true,
                    "cname_chain": [
                      {
                        "name": "shop.example.com",
                        "target": "gone-user.github.io",
                        "ttl": 300
                      }
                    ],
                    "final_target": "gone-user.github.io",
                    "final_status": "ok",
                    "addresses": [
                      "185.199.108.153"
                    ],
                    "provider": {
                      "id": "github-pages",
                      "name": "GitHub Pages",
                      "takeover": "possible"
                    },
                    "evidence": {
                      "kind": "http",
                      "http_status": 404,
                      "matched": "There isn't a GitHub Pages site here."
                    },
                    "risk": "high",
                    "min_ttl": 300
                  },
                  "credits_remaining": 498
                }
              }
            }
          },
          "202": {
            "description": "More names than run at once: a job",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobStartResponse"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ],
        "x-dnssuper-tool": "subdomain-takeover-check",
        "x-dnssuper-price": "Costs 1 credit per name; cached answers cost the same. Names that fail upstream are free.",
        "x-dnssuper-cache": "Answers are cached for the lowest record TTL, between 1 minute and 1 hour; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "check_dangling_records",
          "example": "shop.example.com looks like it could be taken over: GitHub Pages says it has no site for this name.\nRisk: high (GitHub Pages)\nChain: shop.example.com -> gone-user.github.io\nEvidence: the page says \"There isn't a GitHub Pages site here.\" (HTTP 404)\n- fail: This name points to a service where it looks unclaimed. Fix: Remove the DNS record now, or set the name up again in your account at that service.\nCredits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/lookalikes": {
      "get": {
        "tags": [
          "Domain and DNS"
        ],
        "summary": "Lookalike detection",
        "description": "Lookalike variants of a domain (typos, look-alike characters, other endings, bit flips), and, as a job, which of them are registered, with their nameservers, mail servers, homepage title, registration date and a risk rating. Free; any API key works and nothing is charged. With check=true it costs credits (1 per 10 checked) and runs as a job: the most it can cost is reserved when it starts, and only what was done is charged when it finishes. Failed runs are free. Answers are cached for up to 1 hour; send fresh=true to ask the source again.",
        "operationId": "run_lookalike_domains",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "Your domain; reduced to its registrable part.",
              "examples": [
                "example.com"
              ],
              "title": "Domain"
            },
            "description": "Your domain; reduced to its registrable part."
          },
          {
            "name": "typos",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Missing, doubled, swapped and extra letters, keyboard slips, vowel swaps, hyphens and dots.",
              "default": true,
              "title": "Typos"
            },
            "description": "Missing, doubled, swapped and extra letters, keyboard slips, vowel swaps, hyphens and dots."
          },
          {
            "name": "homoglyphs",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Characters that look like yours: rn for m, accented, Cyrillic and Greek letters.",
              "default": true,
              "title": "Homoglyphs"
            },
            "description": "Characters that look like yours: rn for m, accented, Cyrillic and Greek letters."
          },
          {
            "name": "tld_swaps",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "The same name under other endings, such as .co or .net.",
              "default": true,
              "title": "Tld Swaps"
            },
            "description": "The same name under other endings, such as .co or .net."
          },
          {
            "name": "bitsquatting",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "One-bit flips of a letter (memory errors).",
              "default": true,
              "title": "Bitsquatting"
            },
            "description": "One-bit flips of a letter (memory errors)."
          },
          {
            "name": "max_checks",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 500,
              "minimum": 10,
              "description": "Check at most this many variants, the most similar first. 1 credit per 10.",
              "default": 200,
              "title": "Max Checks"
            },
            "description": "Check at most this many variants, the most similar first. 1 credit per 10."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/LookalikeDomainsResponse"
                },
                "example": {
                  "tool": "lookalike-domains",
                  "target": "example.com",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 0,
                  "summary": "241 lookalikes of example.com; checking the 200 most similar costs 20 credits.",
                  "findings": [],
                  "data": {
                    "mode": "generate",
                    "domain": "example.com",
                    "unicode": "example.com",
                    "generated": 241,
                    "max_checks": 200,
                    "checked": 0,
                    "not_reached": 0,
                    "by_kind": {
                      "omission": 7,
                      "repetition": 7,
                      "transposition": 6,
                      "adjacent_key": 29,
                      "insertion": 51,
                      "vowel_swap": 12,
                      "bitsquatting": 22,
                      "hyphenation": 6,
                      "dot_insertion": 3,
                      "ascii_lookalike": 4,
                      "homoglyph": 63,
                      "tld_swap": 31
                    },
                    "variants": [
                      {
                        "name": "xn--eample-w77b.com",
                        "unicode": "eẍample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "xn--examle-lza.com",
                        "unicode": "examþle.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "xn--exampe-0cb.com",
                        "unicode": "exampļe.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "xn--exampe-0r7b.com",
                        "unicode": "exampḽe.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "xn--exampe-fdb.com",
                        "unicode": "exampľe.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "xn--exampe-mcb.com",
                        "unicode": "exampĺe.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "xn--exampe-tq7b.com",
                        "unicode": "exampḷe.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "xn--exampl-14a.com",
                        "unicode": "examplę.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "xn--exampl-1i8b.com",
                        "unicode": "examplế.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "xn--exampl-8h8b.com",
                        "unicode": "examplẻ.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "xn--exampl-8j8b.com",
                        "unicode": "examplễ.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "xn--exampl-8ua.com",
                        "unicode": "examplè.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "xn--exampl-g5a.com",
                        "unicode": "examplě.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "xn--exampl-gj8b.com",
                        "unicode": "examplề.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "xn--exampl-gva.com",
                        "unicode": "examplé.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "xn--exampl-n4a.com",
                        "unicode": "examplė.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "xn--exampl-ni8b.com",
                        "unicode": "examplẽ.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "xn--exampl-nk8b.com",
                        "unicode": "examplệ.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "xn--exampl-nva.com",
                        "unicode": "examplê.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "xn--exampl-u3a.com",
                        "unicode": "examplē.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "xn--exampl-uh8b.com",
                        "unicode": "examplẹ.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "xn--exampl-uj8b.com",
                        "unicode": "examplể.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "xn--exampl-uva.com",
                        "unicode": "examplë.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "xn--exaple-5s7b.com",
                        "unicode": "exaṃple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "xn--exaple-ds7b.com",
                        "unicode": "exaḿple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "xn--exmple-45b.com",
                        "unicode": "exǎmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-4d8b.com",
                        "unicode": "exầmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-4f8b.com",
                        "unicode": "exằmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-4ta.com",
                        "unicode": "exãmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-4za.com",
                        "unicode": "exāmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-cd8b.com",
                        "unicode": "exảmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-cf8b.com",
                        "unicode": "exậmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-ch8b.com",
                        "unicode": "exặmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-cua.com",
                        "unicode": "exämple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-j0a.com",
                        "unicode": "exămple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-je8b.com",
                        "unicode": "exẩmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-jg8b.com",
                        "unicode": "exẳmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-jta.com",
                        "unicode": "exàmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-jua.com",
                        "unicode": "exåmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-qd8b.com",
                        "unicode": "exấmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-qf8b.com",
                        "unicode": "exắmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-qta.com",
                        "unicode": "exámple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-x0a.com",
                        "unicode": "exąmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-xc8b.com",
                        "unicode": "exạmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-xe8b.com",
                        "unicode": "exẫmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-xg8b.com",
                        "unicode": "exẵmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--exmple-xta.com",
                        "unicode": "exâmple.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xn--xample-2h8b.com",
                        "unicode": "ẻxample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "xn--xample-2j8b.com",
                        "unicode": "ễxample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "xn--xample-2ua.com",
                        "unicode": "èxample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "xn--xample-94a.com",
                        "unicode": "ěxample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "xn--xample-9i8b.com",
                        "unicode": "ềxample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "xn--xample-9ua.com",
                        "unicode": "éxample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "xn--xample-h4a.com",
                        "unicode": "ėxample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "xn--xample-hi8b.com",
                        "unicode": "ẽxample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "xn--xample-hk8b.com",
                        "unicode": "ệxample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "xn--xample-hva.com",
                        "unicode": "êxample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "xn--xample-o3a.com",
                        "unicode": "ēxample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "xn--xample-oh8b.com",
                        "unicode": "ẹxample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "xn--xample-oj8b.com",
                        "unicode": "ểxample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "xn--xample-ova.com",
                        "unicode": "ëxample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "xn--xample-v4a.com",
                        "unicode": "ęxample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "xn--xample-vi8b.com",
                        "unicode": "ếxample.com",
                        "kind": "homoglyph",
                        "similarity": 95,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "examp1e.com",
                        "unicode": "examp1e.com",
                        "kind": "ascii_lookalike",
                        "similarity": 90,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "exampie.com",
                        "unicode": "exampie.com",
                        "kind": "ascii_lookalike",
                        "similarity": 90,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "exannple.com",
                        "unicode": "exannple.com",
                        "kind": "ascii_lookalike",
                        "similarity": 90,
                        "changed": [
                          3,
                          4
                        ]
                      },
                      {
                        "name": "exarnple.com",
                        "unicode": "exarnple.com",
                        "kind": "ascii_lookalike",
                        "similarity": 90,
                        "changed": [
                          3,
                          4
                        ]
                      },
                      {
                        "name": "eaxmple.com",
                        "unicode": "eaxmple.com",
                        "kind": "transposition",
                        "similarity": 80,
                        "changed": [
                          1,
                          2
                        ]
                      },
                      {
                        "name": "examlpe.com",
                        "unicode": "examlpe.com",
                        "kind": "transposition",
                        "similarity": 80,
                        "changed": [
                          4,
                          5
                        ]
                      },
                      {
                        "name": "exampel.com",
                        "unicode": "exampel.com",
                        "kind": "transposition",
                        "similarity": 80,
                        "changed": [
                          5,
                          6
                        ]
                      },
                      {
                        "name": "exapmle.com",
                        "unicode": "exapmle.com",
                        "kind": "transposition",
                        "similarity": 80,
                        "changed": [
                          3,
                          4
                        ]
                      },
                      {
                        "name": "exmaple.com",
                        "unicode": "exmaple.com",
                        "kind": "transposition",
                        "similarity": 80,
                        "changed": [
                          2,
                          3
                        ]
                      },
                      {
                        "name": "xeample.com",
                        "unicode": "xeample.com",
                        "kind": "transposition",
                        "similarity": 80,
                        "changed": [
                          0,
                          1
                        ]
                      },
                      {
                        "name": "eample.com",
                        "unicode": "eample.com",
                        "kind": "omission",
                        "similarity": 75,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "examle.com",
                        "unicode": "examle.com",
                        "kind": "omission",
                        "similarity": 75,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "exampe.com",
                        "unicode": "exampe.com",
                        "kind": "omission",
                        "similarity": 75,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "exampl.com",
                        "unicode": "exampl.com",
                        "kind": "omission",
                        "similarity": 75,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "exaple.com",
                        "unicode": "exaple.com",
                        "kind": "omission",
                        "similarity": 75,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "exmple.com",
                        "unicode": "exmple.com",
                        "kind": "omission",
                        "similarity": 75,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "xample.com",
                        "unicode": "xample.com",
                        "kind": "omission",
                        "similarity": 75,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "eexample.com",
                        "unicode": "eexample.com",
                        "kind": "repetition",
                        "similarity": 75,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "exaample.com",
                        "unicode": "exaample.com",
                        "kind": "repetition",
                        "similarity": 75,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "exammple.com",
                        "unicode": "exammple.com",
                        "kind": "repetition",
                        "similarity": 75,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "examplee.com",
                        "unicode": "examplee.com",
                        "kind": "repetition",
                        "similarity": 75,
                        "changed": [
                          7
                        ]
                      },
                      {
                        "name": "examplle.com",
                        "unicode": "examplle.com",
                        "kind": "repetition",
                        "similarity": 75,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "exampple.com",
                        "unicode": "exampple.com",
                        "kind": "repetition",
                        "similarity": 75,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "exxample.com",
                        "unicode": "exxample.com",
                        "kind": "repetition",
                        "similarity": 75,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "3xample.com",
                        "unicode": "3xample.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "4xample.com",
                        "unicode": "4xample.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "dxample.com",
                        "unicode": "dxample.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "ecample.com",
                        "unicode": "ecample.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "edample.com",
                        "unicode": "edample.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "esample.com",
                        "unicode": "esample.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "exajple.com",
                        "unicode": "exajple.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "exakple.com",
                        "unicode": "exakple.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "exam0le.com",
                        "unicode": "exam0le.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "examlle.com",
                        "unicode": "examlle.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "examole.com",
                        "unicode": "examole.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "exampke.com",
                        "unicode": "exampke.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "exampl3.com",
                        "unicode": "exampl3.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "exampl4.com",
                        "unicode": "exampl4.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "exampld.com",
                        "unicode": "exampld.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "examplr.com",
                        "unicode": "examplr.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "exampls.com",
                        "unicode": "exampls.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "examplw.com",
                        "unicode": "examplw.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "exampoe.com",
                        "unicode": "exampoe.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "examppe.com",
                        "unicode": "examppe.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "exanple.com",
                        "unicode": "exanple.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "exqmple.com",
                        "unicode": "exqmple.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "exsmple.com",
                        "unicode": "exsmple.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "exwmple.com",
                        "unicode": "exwmple.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "exzmple.com",
                        "unicode": "exzmple.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "ezample.com",
                        "unicode": "ezample.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "rxample.com",
                        "unicode": "rxample.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "sxample.com",
                        "unicode": "sxample.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "wxample.com",
                        "unicode": "wxample.com",
                        "kind": "adjacent_key",
                        "similarity": 70,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "axample.com",
                        "unicode": "axample.com",
                        "kind": "vowel_swap",
                        "similarity": 70,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "exampla.com",
                        "unicode": "exampla.com",
                        "kind": "vowel_swap",
                        "similarity": 70,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "exampli.com",
                        "unicode": "exampli.com",
                        "kind": "vowel_swap",
                        "similarity": 70,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "examplo.com",
                        "unicode": "examplo.com",
                        "kind": "vowel_swap",
                        "similarity": 70,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "examplu.com",
                        "unicode": "examplu.com",
                        "kind": "vowel_swap",
                        "similarity": 70,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "exemple.com",
                        "unicode": "exemple.com",
                        "kind": "vowel_swap",
                        "similarity": 70,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "eximple.com",
                        "unicode": "eximple.com",
                        "kind": "vowel_swap",
                        "similarity": 70,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "exomple.com",
                        "unicode": "exomple.com",
                        "kind": "vowel_swap",
                        "similarity": 70,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "exumple.com",
                        "unicode": "exumple.com",
                        "kind": "vowel_swap",
                        "similarity": 70,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "ixample.com",
                        "unicode": "ixample.com",
                        "kind": "vowel_swap",
                        "similarity": 70,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "oxample.com",
                        "unicode": "oxample.com",
                        "kind": "vowel_swap",
                        "similarity": 70,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "uxample.com",
                        "unicode": "uxample.com",
                        "kind": "vowel_swap",
                        "similarity": 70,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "example.cm",
                        "unicode": "example.cm",
                        "kind": "tld_swap",
                        "similarity": 70,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.co",
                        "unicode": "example.co",
                        "kind": "tld_swap",
                        "similarity": 70,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.om",
                        "unicode": "example.om",
                        "kind": "tld_swap",
                        "similarity": 70,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "3example.com",
                        "unicode": "3example.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "4example.com",
                        "unicode": "4example.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "dexample.com",
                        "unicode": "dexample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "e3xample.com",
                        "unicode": "e3xample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "e4xample.com",
                        "unicode": "e4xample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "ecxample.com",
                        "unicode": "ecxample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "edxample.com",
                        "unicode": "edxample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "erxample.com",
                        "unicode": "erxample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "esxample.com",
                        "unicode": "esxample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "ewxample.com",
                        "unicode": "ewxample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "exajmple.com",
                        "unicode": "exajmple.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "exakmple.com",
                        "unicode": "exakmple.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "exam0ple.com",
                        "unicode": "exam0ple.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "examjple.com",
                        "unicode": "examjple.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "examkple.com",
                        "unicode": "examkple.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "examlple.com",
                        "unicode": "examlple.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "examnple.com",
                        "unicode": "examnple.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "examople.com",
                        "unicode": "examople.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "examp0le.com",
                        "unicode": "examp0le.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "exampkle.com",
                        "unicode": "exampkle.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "exampl3e.com",
                        "unicode": "exampl3e.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "exampl4e.com",
                        "unicode": "exampl4e.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "examplde.com",
                        "unicode": "examplde.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "example3.com",
                        "unicode": "example3.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          7
                        ]
                      },
                      {
                        "name": "example4.com",
                        "unicode": "example4.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          7
                        ]
                      },
                      {
                        "name": "exampled.com",
                        "unicode": "exampled.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          7
                        ]
                      },
                      {
                        "name": "exampler.com",
                        "unicode": "exampler.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          7
                        ]
                      },
                      {
                        "name": "examples.com",
                        "unicode": "examples.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          7
                        ]
                      },
                      {
                        "name": "examplew.com",
                        "unicode": "examplew.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          7
                        ]
                      },
                      {
                        "name": "examplke.com",
                        "unicode": "examplke.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "examploe.com",
                        "unicode": "examploe.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "examplpe.com",
                        "unicode": "examplpe.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "examplre.com",
                        "unicode": "examplre.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "examplse.com",
                        "unicode": "examplse.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "examplwe.com",
                        "unicode": "examplwe.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "exampole.com",
                        "unicode": "exampole.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "exanmple.com",
                        "unicode": "exanmple.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "exaqmple.com",
                        "unicode": "exaqmple.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "exasmple.com",
                        "unicode": "exasmple.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "exawmple.com",
                        "unicode": "exawmple.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "exazmple.com",
                        "unicode": "exazmple.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "excample.com",
                        "unicode": "excample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "exdample.com",
                        "unicode": "exdample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "exqample.com",
                        "unicode": "exqample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "exsample.com",
                        "unicode": "exsample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "exwample.com",
                        "unicode": "exwample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "exzample.com",
                        "unicode": "exzample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "ezxample.com",
                        "unicode": "ezxample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "rexample.com",
                        "unicode": "rexample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "sexample.com",
                        "unicode": "sexample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "wexample.com",
                        "unicode": "wexample.com",
                        "kind": "insertion",
                        "similarity": 65,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "e-xample.com",
                        "unicode": "e-xample.com",
                        "kind": "hyphenation",
                        "similarity": 65,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "ex-ample.com",
                        "unicode": "ex-ample.com",
                        "kind": "hyphenation",
                        "similarity": 65,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "exa-mple.com",
                        "unicode": "exa-mple.com",
                        "kind": "hyphenation",
                        "similarity": 65,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "exam-ple.com",
                        "unicode": "exam-ple.com",
                        "kind": "hyphenation",
                        "similarity": 65,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "examp-le.com",
                        "unicode": "examp-le.com",
                        "kind": "hyphenation",
                        "similarity": 65,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "exampl-e.com",
                        "unicode": "exampl-e.com",
                        "kind": "hyphenation",
                        "similarity": 65,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "e8ample.com",
                        "unicode": "e8ample.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "ehample.com",
                        "unicode": "ehample.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "epample.com",
                        "unicode": "epample.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "exa-ple.com",
                        "unicode": "exa-ple.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "exaeple.com",
                        "unicode": "exaeple.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "exaiple.com",
                        "unicode": "exaiple.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "exalple.com",
                        "unicode": "exalple.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "exampde.com",
                        "unicode": "exampde.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "examphe.com",
                        "unicode": "examphe.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "examplg.com",
                        "unicode": "examplg.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "examplm.com",
                        "unicode": "examplm.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          6
                        ]
                      },
                      {
                        "name": "exampme.com",
                        "unicode": "exampme.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "exampne.com",
                        "unicode": "exampne.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          5
                        ]
                      },
                      {
                        "name": "examqle.com",
                        "unicode": "examqle.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "examrle.com",
                        "unicode": "examrle.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "examtle.com",
                        "unicode": "examtle.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "examxle.com",
                        "unicode": "examxle.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          4
                        ]
                      },
                      {
                        "name": "exaople.com",
                        "unicode": "exaople.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "excmple.com",
                        "unicode": "excmple.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "eyample.com",
                        "unicode": "eyample.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          1
                        ]
                      },
                      {
                        "name": "gxample.com",
                        "unicode": "gxample.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "mxample.com",
                        "unicode": "mxample.com",
                        "kind": "bitsquatting",
                        "similarity": 60,
                        "changed": [
                          0
                        ]
                      },
                      {
                        "name": "example.ai",
                        "unicode": "example.ai",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.app",
                        "unicode": "example.app",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9,
                          10
                        ]
                      },
                      {
                        "name": "example.au",
                        "unicode": "example.au",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.biz",
                        "unicode": "example.biz",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9,
                          10
                        ]
                      },
                      {
                        "name": "example.ca",
                        "unicode": "example.ca",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.cc",
                        "unicode": "example.cc",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.co.uk",
                        "unicode": "example.co.uk",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9,
                          10,
                          11,
                          12
                        ]
                      },
                      {
                        "name": "example.de",
                        "unicode": "example.de",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.dev",
                        "unicode": "example.dev",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9,
                          10
                        ]
                      },
                      {
                        "name": "example.es",
                        "unicode": "example.es",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.eu",
                        "unicode": "example.eu",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.fr",
                        "unicode": "example.fr",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.in",
                        "unicode": "example.in",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.info",
                        "unicode": "example.info",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9,
                          10,
                          11
                        ]
                      },
                      {
                        "name": "example.io",
                        "unicode": "example.io",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.it",
                        "unicode": "example.it",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.me",
                        "unicode": "example.me",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.net",
                        "unicode": "example.net",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9,
                          10
                        ]
                      },
                      {
                        "name": "example.nl",
                        "unicode": "example.nl",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.online",
                        "unicode": "example.online",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9,
                          10,
                          11,
                          12,
                          13
                        ]
                      },
                      {
                        "name": "example.org",
                        "unicode": "example.org",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9,
                          10
                        ]
                      },
                      {
                        "name": "example.shop",
                        "unicode": "example.shop",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9,
                          10,
                          11
                        ]
                      },
                      {
                        "name": "example.site",
                        "unicode": "example.site",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9,
                          10,
                          11
                        ]
                      },
                      {
                        "name": "example.store",
                        "unicode": "example.store",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9,
                          10,
                          11,
                          12
                        ]
                      },
                      {
                        "name": "example.tv",
                        "unicode": "example.tv",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.uk",
                        "unicode": "example.uk",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.us",
                        "unicode": "example.us",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9
                        ]
                      },
                      {
                        "name": "example.xyz",
                        "unicode": "example.xyz",
                        "kind": "tld_swap",
                        "similarity": 60,
                        "changed": [
                          8,
                          9,
                          10
                        ]
                      },
                      {
                        "name": "ample.com",
                        "unicode": "ex.ample.com",
                        "host": "ex.ample.com",
                        "kind": "dot_insertion",
                        "similarity": 50,
                        "changed": [
                          2
                        ]
                      },
                      {
                        "name": "mple.com",
                        "unicode": "exa.mple.com",
                        "host": "exa.mple.com",
                        "kind": "dot_insertion",
                        "similarity": 50,
                        "changed": [
                          3
                        ]
                      },
                      {
                        "name": "ple.com",
                        "unicode": "exam.ple.com",
                        "host": "exam.ple.com",
                        "kind": "dot_insertion",
                        "similarity": 50,
                        "changed": [
                          4
                        ]
                      }
                    ],
                    "registered": [],
                    "no_dns": [],
                    "unknown": [],
                    "whois_looked_up": 0,
                    "whois_skipped": 0,
                    "titles_fetched": 0,
                    "price_to_check": 20
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "lookalike-domains",
        "x-dnssuper-price": "Free; any API key works and nothing is charged. With check=true it costs credits (1 per 10 checked) and runs as a job: the most it can cost is reserved when it starts, and only what was done is charged when it finishes. Failed runs are free.",
        "x-dnssuper-cache": "Answers are cached for up to 1 hour; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "find_lookalikes",
          "example": "241 lookalikes of example.com; checking the 200 most similar costs 20 credits.\nGenerated 241 lookalikes: homoglyph 63, insertion 51, tld_swap 31, +9 kinds\nMost similar: eẍample.com, examþle.com, exampļe.com, exampḽe.com\nexampľe.com, exampĺe.com, exampḷe.com, examplę.com\nexamplế.com, examplẻ.com, examplễ.com, examplè.com\nChecking the 200 most similar costs 20 credits; call again with check=true.\nNo issues found.\nFree | checked 2026-11-14 10:00 UTC\n"
        }
      },
      "post": {
        "tags": [
          "Domain and DNS"
        ],
        "summary": "Lookalike detection (check)",
        "description": "Lookalike variants of a domain (typos, look-alike characters, other endings, bit flips), and, as a job, which of them are registered, with their nameservers, mail servers, homepage title, registration date and a risk rating. With `check: true` this runs as a job: the answer is a 202 with the job's links. Without it, use `GET /v1/lookalikes`. Free; any API key works and nothing is charged. With check=true it costs credits (1 per 10 checked) and runs as a job: the most it can cost is reserved when it starts, and only what was done is charged when it finishes. Failed runs are free.",
        "operationId": "run_lookalike_domains_check",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/LookalikeDomainsParams"
              },
              "example": {
                "domain": "example.com",
                "check": true,
                "max_checks": 10
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobStartResponse"
                },
                "example": {
                  "job_id": "aa73c218-1d34-5ac5-988d-20152141e703",
                  "status": "queued",
                  "total": 1,
                  "credits_reserved": 1,
                  "duplicates_removed": 0,
                  "job_url": "https://api.dnssuper.localhost/v1/jobs/aa73c218-1d34-5ac5-988d-20152141e703",
                  "items_url": "https://api.dnssuper.localhost/v1/jobs/aa73c218-1d34-5ac5-988d-20152141e703/items",
                  "events_url": "https://api.dnssuper.localhost/v1/jobs/aa73c218-1d34-5ac5-988d-20152141e703/events"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "lookalike-domains",
        "x-dnssuper-price": "Free; any API key works and nothing is charged. With check=true it costs credits (1 per 10 checked) and runs as a job: the most it can cost is reserved when it starts, and only what was done is charged when it finishes. Failed runs are free.",
        "x-dnssuper-cache": "Answers are cached for up to 1 hour; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "find_lookalikes",
          "example": "2 of 10 lookalikes of example.com are registered; 1 looks risky: new, set up for email or very similar.\nChecked 10: 2 registered, 8 no DNS\nexampľe.com risk 99 high [new mail web] created 2026-10-20\nexamþle.com risk 24 low\n- fail: A risky lookalike of your domain is registered. Fix: Block it in your mail gateway, enforce DMARC, and report abuse to its registrar.\n- warn: A lookalike of your domain can receive email. Fix: Block the domain in your mail gateway and warn your team about messages from it.\n- warn: A lookalike of your domain was registered in the last 90 days. Fix: Watch it with a lookalike monitor and block it in your mail gateway.\n- warn: A lookalike that uses similar-looking characters is registered. Fix: Block it in your mail gateway; it is hard to tell apart from your domain.\n+4 more findings (pass detail='full' to see all)\nCredits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        },
        "x-dnssuper-variant": "check"
      }
    },
    "/v1/expiry-calendar": {
      "post": {
        "tags": [
          "Domain and DNS"
        ],
        "summary": "Expiry calendar",
        "description": "Each domain's expiry date, days left, state (active, expiring, expired, ending, not registered or unknown), registrar name and EPP status codes, from the registry's RDAP or WHOIS service. Costs 2 credits per name; cached answers cost the same. Names that fail upstream are free. Never cached; every call runs again.",
        "operationId": "run_domain_expiry_calendar",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DomainExpiryCalendarParams"
              },
              "example": {
                "domains": [
                  "verisign.com"
                ]
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "More names than run at once: a job",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobStartResponse"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ],
        "x-dnssuper-tool": "domain-expiry-calendar",
        "x-dnssuper-price": "Costs 2 credits per name; cached answers cost the same. Names that fail upstream are free.",
        "x-dnssuper-cache": "Never cached; every call runs again.",
        "x-dnssuper-mcp": {
          "tool": "export_expiry_calendar",
          "example": "verisign.com expires on 1 June 2034 (in 2756 days).\nExpires: 1 Jun 2034 (2756 days); state active\nRegistrar: CSC Corporate Domains, Inc.\nStatuses: clientDeleteProhibited, clientTransferProhibited, clientUpdateProhibited, serverDeleteProhibited, serverTransferProhibited, serverUpdateProhibited\nNo issues found.\nCredits: 2 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/email-audit": {
      "get": {
        "tags": [
          "Email"
        ],
        "summary": "Email setup audit",
        "description": "The domain's MX, SPF (with its lookup count), DMARC and DKIM records, the mail provider they point to, and the findings that set the grade. Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for the lowest record TTL, between 1 minute and 1 hour; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_email_checker",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "A domain, URL or email address; for an email address only the part after @ is used.",
              "examples": [
                "example.com"
              ],
              "title": "Domain"
            },
            "description": "A domain, URL or email address; for an email address only the part after @ is used."
          },
          {
            "name": "selector",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "minLength": 1,
                  "maxLength": 253,
                  "pattern": "^[A-Za-z0-9_-]+(\\.[A-Za-z0-9_-]+)*$"
                },
                {
                  "type": "null"
                }
              ],
              "description": "A DKIM selector to try first, such as s1.",
              "x-advanced": true,
              "title": "Selector"
            },
            "description": "A DKIM selector to try first, such as s1."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EmailCheckerResponse"
                },
                "example": {
                  "tool": "email-checker",
                  "target": "example.com",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 2,
                  "summary": "Email for example.com is set up well: grade A, 100 of 100. Mail is handled by Google Workspace.",
                  "score": 100,
                  "findings": [
                    {
                      "id": "spf.softfail_all",
                      "severity": "info",
                      "title": "Your SPF record ends in ~all",
                      "detail": "",
                      "fix": "Move to -all once DMARC reports show all your mail passes."
                    },
                    {
                      "id": "bimi.missing",
                      "severity": "info",
                      "title": "No BIMI record",
                      "detail": "",
                      "fix": "Publish a BIMI record if you want your logo shown next to your mail in supporting inboxes."
                    },
                    {
                      "id": "mx.ok",
                      "severity": "pass",
                      "title": "Your mail servers are set up",
                      "detail": "",
                      "fix": "Nothing to do."
                    },
                    {
                      "id": "spf.valid",
                      "severity": "pass",
                      "title": "Your SPF record is valid",
                      "detail": "",
                      "fix": "Nothing to do."
                    },
                    {
                      "id": "dmarc.enforced",
                      "severity": "pass",
                      "title": "Your DMARC policy is enforced",
                      "detail": "p=reject",
                      "fix": "Nothing to do."
                    },
                    {
                      "id": "dkim.found",
                      "severity": "pass",
                      "title": "DKIM keys found",
                      "detail": "google",
                      "fix": "Nothing to do."
                    },
                    {
                      "id": "mta_sts.enforced",
                      "severity": "pass",
                      "title": "MTA-STS is enforced",
                      "detail": "",
                      "fix": "Nothing to do; keep the policy's mx lines in step with your MX records."
                    },
                    {
                      "id": "tls_rpt.valid",
                      "severity": "pass",
                      "title": "TLS reporting is set up",
                      "detail": "",
                      "fix": "Nothing to do; read the reports now and then."
                    }
                  ],
                  "data": {
                    "name": "example.com",
                    "unicode": "example.com",
                    "nxdomain": false,
                    "providers": [
                      {
                        "id": "google-workspace",
                        "name": "Google Workspace",
                        "source": "mx"
                      }
                    ],
                    "mx": {
                      "status": "found",
                      "null_mx": false,
                      "implicit": false,
                      "records": [
                        {
                          "preference": 1,
                          "host": "aspmx.l.google.com",
                          "ttl": 3600,
                          "is_ip": false,
                          "A": [
                            "142.250.27.26"
                          ],
                          "AAAA": [
                            "2a00:1450:4025:401::1a"
                          ],
                          "status": "ok",
                          "provider": "google-workspace"
                        },
                        {
                          "preference": 5,
                          "host": "alt1.aspmx.l.google.com",
                          "ttl": 3600,
                          "is_ip": false,
                          "A": [
                            "142.250.153.27"
                          ],
                          "AAAA": [],
                          "status": "ok",
                          "provider": "google-workspace"
                        }
                      ]
                    },
                    "spf": {
                      "status": "found",
                      "record": "v=spf1 include:_spf.google.com ~all",
                      "records": [
                        "v=spf1 include:_spf.google.com ~all"
                      ],
                      "all": "~all",
                      "lookups": 4,
                      "lookup_limit": 10,
                      "void_lookups": 0,
                      "capped": false,
                      "tree": {
                        "domain": "example.com",
                        "status": "found",
                        "record": "v=spf1 include:_spf.google.com ~all",
                        "errors": [],
                        "terms": [
                          {
                            "term": "include:_spf.google.com",
                            "mechanism": "include",
                            "qualifier": "+",
                            "target": "_spf.google.com",
                            "counted": true,
                            "status": "ok",
                            "addresses": [],
                            "hosts": [],
                            "detail": "",
                            "child": {
                              "domain": "_spf.google.com",
                              "status": "found",
                              "record": "v=spf1 include:_netblocks.google.com include:_netblocks2.google.com include:_netblocks3.google.com ~all",
                              "errors": [],
                              "terms": [
                                {
                                  "term": "include:_netblocks.google.com",
                                  "mechanism": "include",
                                  "qualifier": "+",
                                  "target": "_netblocks.google.com",
                                  "counted": true,
                                  "status": "ok",
                                  "addresses": [],
                                  "hosts": [],
                                  "detail": "",
                                  "child": {
                                    "domain": "_netblocks.google.com",
                                    "status": "found",
                                    "record": "v=spf1 ip4:35.190.247.0/24 ip4:64.233.160.0/19 ip4:66.102.0.0/20 ip4:66.249.80.0/20 ip4:72.14.192.0/18 ~all",
                                    "errors": [],
                                    "terms": [
                                      {
                                        "term": "ip4:35.190.247.0/24",
                                        "mechanism": "ip4",
                                        "qualifier": "+",
                                        "target": "35.190.247.0",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "ip4:64.233.160.0/19",
                                        "mechanism": "ip4",
                                        "qualifier": "+",
                                        "target": "64.233.160.0",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "ip4:66.102.0.0/20",
                                        "mechanism": "ip4",
                                        "qualifier": "+",
                                        "target": "66.102.0.0",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "ip4:66.249.80.0/20",
                                        "mechanism": "ip4",
                                        "qualifier": "+",
                                        "target": "66.249.80.0",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "ip4:72.14.192.0/18",
                                        "mechanism": "ip4",
                                        "qualifier": "+",
                                        "target": "72.14.192.0",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "~all",
                                        "mechanism": "all",
                                        "qualifier": "~",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      }
                                    ]
                                  }
                                },
                                {
                                  "term": "include:_netblocks2.google.com",
                                  "mechanism": "include",
                                  "qualifier": "+",
                                  "target": "_netblocks2.google.com",
                                  "counted": true,
                                  "status": "ok",
                                  "addresses": [],
                                  "hosts": [],
                                  "detail": "",
                                  "child": {
                                    "domain": "_netblocks2.google.com",
                                    "status": "found",
                                    "record": "v=spf1 ip6:2001:4860:4000::/36 ip6:2404:6800:4000::/36 ip6:2607:f8b0:4000::/36 ~all",
                                    "errors": [],
                                    "terms": [
                                      {
                                        "term": "ip6:2001:4860:4000::/36",
                                        "mechanism": "ip6",
                                        "qualifier": "+",
                                        "target": "2001:4860:4000::",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "ip6:2404:6800:4000::/36",
                                        "mechanism": "ip6",
                                        "qualifier": "+",
                                        "target": "2404:6800:4000::",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "ip6:2607:f8b0:4000::/36",
                                        "mechanism": "ip6",
                                        "qualifier": "+",
                                        "target": "2607:f8b0:4000::",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "~all",
                                        "mechanism": "all",
                                        "qualifier": "~",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      }
                                    ]
                                  }
                                },
                                {
                                  "term": "include:_netblocks3.google.com",
                                  "mechanism": "include",
                                  "qualifier": "+",
                                  "target": "_netblocks3.google.com",
                                  "counted": true,
                                  "status": "ok",
                                  "addresses": [],
                                  "hosts": [],
                                  "detail": "",
                                  "child": {
                                    "domain": "_netblocks3.google.com",
                                    "status": "found",
                                    "record": "v=spf1 ip4:172.217.0.0/19 ip4:172.217.32.0/20 ip4:108.177.96.0/19 ~all",
                                    "errors": [],
                                    "terms": [
                                      {
                                        "term": "ip4:172.217.0.0/19",
                                        "mechanism": "ip4",
                                        "qualifier": "+",
                                        "target": "172.217.0.0",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "ip4:172.217.32.0/20",
                                        "mechanism": "ip4",
                                        "qualifier": "+",
                                        "target": "172.217.32.0",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "ip4:108.177.96.0/19",
                                        "mechanism": "ip4",
                                        "qualifier": "+",
                                        "target": "108.177.96.0",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      },
                                      {
                                        "term": "~all",
                                        "mechanism": "all",
                                        "qualifier": "~",
                                        "counted": false,
                                        "status": "ok",
                                        "addresses": [],
                                        "hosts": [],
                                        "detail": ""
                                      }
                                    ]
                                  }
                                },
                                {
                                  "term": "~all",
                                  "mechanism": "all",
                                  "qualifier": "~",
                                  "counted": false,
                                  "status": "ok",
                                  "addresses": [],
                                  "hosts": [],
                                  "detail": ""
                                }
                              ]
                            }
                          },
                          {
                            "term": "~all",
                            "mechanism": "all",
                            "qualifier": "~",
                            "counted": false,
                            "status": "ok",
                            "addresses": [],
                            "hosts": [],
                            "detail": ""
                          }
                        ]
                      }
                    },
                    "dmarc": {
                      "status": "found",
                      "name": "_dmarc.example.com",
                      "source": "exact",
                      "record": "v=DMARC1; p=reject; rua=mailto:dmarc@example.com",
                      "policy": "reject",
                      "effective_policy": "reject",
                      "pct": 100,
                      "adkim": "r",
                      "aspf": "r",
                      "reports": [
                        {
                          "kind": "rua",
                          "uri": "mailto:dmarc@example.com",
                          "domain": "example.com",
                          "external": false,
                          "authorized": true
                        }
                      ]
                    },
                    "dkim": {
                      "selectors_tried": [
                        "google",
                        "selector1",
                        "selector2",
                        "zmail",
                        "zoho",
                        "fm1",
                        "fm2",
                        "fm3",
                        "protonmail",
                        "protonmail2",
                        "protonmail3",
                        "hostingermail-a",
                        "hostingermail-b",
                        "hostingermail-c",
                        "sig1",
                        "s1",
                        "s2",
                        "smtp",
                        "mx",
                        "k1",
                        "pic",
                        "k2",
                        "k3",
                        "pm",
                        "brevo1",
                        "brevo2",
                        "mail",
                        "scph0920",
                        "scph1021",
                        "hs1",
                        "hs2",
                        "zendesk1",
                        "zendesk2",
                        "default",
                        "dkim",
                        "selector",
                        "key1",
                        "key2",
                        "email",
                        "dkim1"
                      ],
                      "failed": [],
                      "found": [
                        {
                          "selector": "google",
                          "name": "google._domainkey.example.com",
                          "status": "ok",
                          "key_type": "rsa",
                          "key_bits": 2048,
                          "testing": false,
                          "provider": "google-workspace",
                          "record": "v=DKIM1; k=rsa; p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEApTGFY+knX9gV8lx+vLMRL+4h2Vef2XWTq1+IUtMY/ZRRoGQG31IR2Yz+FkzYaolUU2JMq2NbUzELco8z3Ef/iPmN4wITl7/cTQnwbn15fwvgeP59ICpyWpGtr/aq83ISRBjKEfTlRub1tRG/VVps0QaD4GjVBMGVPLYKKvlT9gG2Bzd86bLTkPOJcVHhjzqytVoqVW09guYc9W6J2XDfTES0ocQ7/p4zDR6/wmR4su5wwcy8C5GpeyKNERmR6w9DvH0c1ySrjtpvBMjDu4LTT4ruHJCHLqbWA1M31nFAi30vasgB0q6JZcEcOyM1ByetpiuqLfWNTLBm+RWQe4BguQIDAQAB"
                        }
                      ]
                    },
                    "policies": {
                      "checked": true,
                      "mta_sts": {
                        "present": true,
                        "record": "v=STSv1; id=2026111401",
                        "verdict": "enforced",
                        "headline": "MTA-STS is enforced: senders must deliver over verified TLS.",
                        "checked": true
                      },
                      "tls_rpt": {
                        "present": true,
                        "record": "v=TLSRPTv1; rua=mailto:tlsrpt@example.com",
                        "verdict": "valid",
                        "headline": "TLS-RPT reports are requested.",
                        "checked": true
                      },
                      "bimi": {
                        "present": false,
                        "verdict": "missing",
                        "headline": "No BIMI record, so no brand logo in inboxes.",
                        "checked": true
                      }
                    },
                    "min_ttl": 300
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "x-dnssuper-tool": "email-checker",
        "x-dnssuper-price": "Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for the lowest record TTL, between 1 minute and 1 hour; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "audit_email",
          "example": "Email for example.com is set up well: grade A, 100 of 100. Mail is handled by Google Workspace.\nScore: 100/100\nProviders: Google Workspace (MX)\nMX: aspmx.l.google.com (1), alt1.aspmx.l.google.com (5)\nSPF: v=spf1 include:_spf.google.com ~all (4 of 10 lookups)\nDMARC: p=reject, 1 report address\nDKIM: google (2048-bit RSA); tried 40 selectors\nPolicies: MTA-STS enforced, TLS-RPT yes, BIMI no\n- info: Your SPF record ends in ~all\n- info: No BIMI record\n6 checks passed\nCredits: 2 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/mail-policies": {
      "get": {
        "tags": [
          "Email"
        ],
        "summary": "MTA-STS, TLS-RPT, BIMI",
        "description": "MTA-STS policy and DNS record, TLS-RPT reporting addresses and BIMI logo and mark certificate facts for a domain's mail. Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 15 minutes; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_mta_sts_checker",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "A domain, URL or email address; for an email address only the part after @ is used.",
              "examples": [
                "example.com"
              ],
              "title": "Domain"
            },
            "description": "A domain, URL or email address; for an email address only the part after @ is used."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MtaStsCheckerResponse"
                },
                "example": {
                  "tool": "mta-sts-checker",
                  "target": "example.com",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 1,
                  "summary": "MTA-STS is enforced for example.com and TLS reports are requested. BIMI is ready to show a logo.",
                  "findings": [
                    {
                      "id": "mta_sts.enforced",
                      "severity": "pass",
                      "title": "MTA-STS is enforced",
                      "detail": "",
                      "fix": "Nothing to do; keep the policy's mx lines in step with your MX records."
                    },
                    {
                      "id": "tls_rpt.valid",
                      "severity": "pass",
                      "title": "TLS reporting is set up",
                      "detail": "",
                      "fix": "Nothing to do; read the reports now and then."
                    },
                    {
                      "id": "bimi.valid",
                      "severity": "pass",
                      "title": "BIMI is set up",
                      "detail": "",
                      "fix": "Nothing to do; keep the logo and certificate current."
                    }
                  ],
                  "data": {
                    "name": "example.com",
                    "unicode": "example.com",
                    "nxdomain": false,
                    "mx_hosts": [
                      "mx1.example.com",
                      "mx2.example.net"
                    ],
                    "mta_sts": {
                      "verdict": "enforced",
                      "record": {
                        "present": true,
                        "records": [
                          "v=STSv1; id=20261101000000"
                        ],
                        "id": "20261101000000",
                        "errors": []
                      },
                      "policy": {
                        "url": "https://mta-sts.example.com/.well-known/mta-sts.txt",
                        "fetched": true,
                        "status": 200,
                        "content_type": "text/plain",
                        "size_bytes": 90,
                        "version": "STSv1",
                        "mode": "enforce",
                        "max_age": 604800,
                        "mx_patterns": [
                          "mx1.example.com",
                          "mx2.example.net"
                        ],
                        "errors": []
                      },
                      "mx": [
                        {
                          "host": "mx1.example.com",
                          "pattern": "mx1.example.com"
                        },
                        {
                          "host": "mx2.example.net",
                          "pattern": "mx2.example.net"
                        }
                      ],
                      "null_mx": false,
                      "mx_certificates": "not_checked"
                    },
                    "tls_rpt": {
                      "verdict": "valid",
                      "present": true,
                      "records": [
                        "v=TLSRPTv1; rua=mailto:tls-reports@example.com"
                      ],
                      "rua": [
                        {
                          "uri": "mailto:tls-reports@example.com",
                          "scheme": "mailto",
                          "valid": true
                        }
                      ]
                    },
                    "bimi": {
                      "verdict": "ready",
                      "present": true,
                      "record": "v=BIMI1; l=https://bimi.example.com/logo.svg; a=https://bimi.example.com/vmc.pem",
                      "logo": {
                        "url": "https://bimi.example.com/logo.svg",
                        "fetched": true,
                        "status": 200,
                        "content_type": "image/svg+xml",
                        "size_bytes": 237,
                        "square": true,
                        "profile_ok": true,
                        "title_present": true,
                        "problems": [],
                        "sha256": "14b0dd49f02a91c94261c4bf59e572be83eac371fc85cfe1177a0c633cf861e5"
                      },
                      "certificate": {
                        "url": "https://bimi.example.com/vmc.pem",
                        "fetched": true,
                        "kind": "vmc",
                        "subject_org": "Example Brand Ltd",
                        "issuer_org": "DNS Super Test Mark CA",
                        "not_before": "2026-10-15T10:00:00Z",
                        "not_after": "2027-11-14T10:00:00Z",
                        "days_left": 365,
                        "domains": [
                          "example.com"
                        ],
                        "covers_domain": true,
                        "eku_ok": true,
                        "mark_type": "Registered Mark"
                      },
                      "dmarc": {
                        "policy": "reject",
                        "pct": 100,
                        "testing": false,
                        "inherited": false,
                        "enforced_for_all": true
                      }
                    },
                    "min_ttl": 3600
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "x-dnssuper-tool": "mta-sts-checker",
        "x-dnssuper-price": "Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for up to 15 minutes; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "check_mail_policies",
          "example": "MTA-STS is enforced for example.com and TLS reports are requested. BIMI is ready to show a logo.\nMTA-STS: enforced (max_age 604800; 2 of 2 MX hosts covered)\nTLS-RPT: reports to mailto:tls-reports@example.com\nBIMI: ready (logo SVG Tiny PS, square; VMC for Example Brand Ltd, 365 days left)\nDMARC for BIMI: p=reject, enforced for all mail\n3 checks passed\nCredits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/headers": {
      "post": {
        "tags": [
          "Email"
        ],
        "summary": "Email header analyzer",
        "description": "The delivery path, authentication results and alignment read from pasted email headers. Free; any API key works and nothing is charged. What you paste is processed in memory and never stored. Never cached; every call runs again.",
        "operationId": "run_email_header_analyzer",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/EmailHeaderAnalyzerParams"
              },
              "example": {
                "headers": "Delivered-To: bob@example.net\r\nReceived: by 2002:a05:6a10:1234:b0:5f1:aaaa:bbbb with SMTP id x12csp123456pxa;\r\n        Fri, 14 Nov 2026 09:00:04 -0800 (PST)\r\nReceived: from mail-out.example.com (mail-out.example.com. [192.0.2.25])\r\n        by mx.example.net with ESMTPS id a1b2c3d4e5.12.2026.11.14.09.00.03\r\n        for <bob@example.net>\r\n        (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256);\r\n        Fri, 14 Nov 2026 09:00:03 -0800 (PST)\r\nReceived: from app.example.com (app.example.com [198.51.100.10])\r\n        by mail-out.example.com (Postfix) with ESMTPS id 4XyZ1q2w3e\r\n        for <bob@example.net>; Fri, 14 Nov 2026 17:00:01 +0000 (UTC)\r\nAuthentication-Results: mx.example.net;\r\n       dkim=pass header.i=@example.com header.s=s1 header.b=AbCdEf12;\r\n       spf=pass (example.net: domain of bounce@example.com designates 192.0.2.25 as permitted sender) smtp.mailfrom=bounce@example.com;\r\n       dmarc=pass (p=REJECT sp=REJECT dis=NONE) header.from=example.com\r\nReturn-Path: <bounce@example.com>\r\nDKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=example.com; s=s1;\r\n        h=from:to:subject:date:message-id; bh=47DEQpj8HBSa+/TImW+5JCeuQeRkm5NMpJWZG3hSuFU=;\r\n        b=AbCdEf12GhIjKl34MnOpQr56StUvWx78YzAbCd90EfGh\r\nFrom: Alice Example <alice@example.com>\r\nTo: Bob Example <bob@example.net>\r\nSubject: Quarterly figures\r\nDate: Fri, 14 Nov 2026 17:00:00 +0000\r\nMessage-ID: <20261114170000.4711@app.example.com>\r\nX-Mailer: Example Mailer 4.2\r\nMIME-Version: 1.0\r\nContent-Type: text/plain; charset=utf-8\r\n"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EmailHeaderAnalyzerResponse"
                },
                "example": {
                  "tool": "email-header-analyzer",
                  "target": "",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 0,
                  "summary": "DMARC passed: the receiver authenticated this message as coming from example.com. It took 3 hops in 3 seconds.",
                  "findings": [
                    {
                      "id": "email_headers.dmarc_pass",
                      "severity": "pass",
                      "title": "The message passed DMARC",
                      "detail": "mx.example.net: example.com",
                      "fix": "Nothing to do."
                    }
                  ],
                  "data": {
                    "header_count": 15,
                    "received_count": 3,
                    "hops": [
                      {
                        "index": 0,
                        "from_helo": "app.example.com",
                        "from_rdns": "app.example.com",
                        "from_ip": "198.51.100.10",
                        "ip_scope": "documentation",
                        "by_host": "mail-out.example.com",
                        "protocol": "ESMTPS",
                        "tls": true,
                        "queue_id": "4XyZ1q2w3e",
                        "received_at": "2026-11-14T17:00:01Z",
                        "clock_skew": false,
                        "largest_delay": false,
                        "boundary": false,
                        "network": {
                          "asn": 64497,
                          "name": "EXEMPLE-RESEAU",
                          "country": "FR"
                        }
                      },
                      {
                        "index": 1,
                        "from_helo": "mail-out.example.com",
                        "from_rdns": "mail-out.example.com",
                        "from_ip": "192.0.2.25",
                        "ip_scope": "documentation",
                        "by_host": "mx.example.net",
                        "protocol": "ESMTPS",
                        "tls": true,
                        "queue_id": "a1b2c3d4e5.12.2026.11.14.09.00.03",
                        "received_at": "2026-11-14T17:00:03Z",
                        "delay_s": 2,
                        "clock_skew": false,
                        "largest_delay": true,
                        "boundary": true,
                        "network": {
                          "asn": 64496,
                          "name": "EXAMPLE-NET",
                          "country": "NL"
                        }
                      },
                      {
                        "index": 2,
                        "by_host": "2002:a05:6a10:1234:b0:5f1:aaaa:bbbb",
                        "protocol": "SMTP",
                        "tls": false,
                        "queue_id": "x12csp123456pxa",
                        "received_at": "2026-11-14T17:00:04Z",
                        "delay_s": 1,
                        "clock_skew": false,
                        "largest_delay": false,
                        "boundary": false
                      }
                    ],
                    "total_transit_s": 3,
                    "auth_results": [
                      {
                        "authserv_id": "mx.example.net",
                        "trusted": true,
                        "spf": {
                          "result": "pass",
                          "domain": "example.com"
                        },
                        "dkim": [
                          {
                            "result": "pass",
                            "domain": "example.com",
                            "selector": "s1"
                          }
                        ],
                        "dmarc": {
                          "result": "pass",
                          "domain": "example.com"
                        },
                        "other": []
                      }
                    ],
                    "alignment": {
                      "from_domains": [
                        "example.com"
                      ],
                      "return_path_domain": "example.com",
                      "spf_aligned": true,
                      "dkim_domains_claimed": [
                        "example.com"
                      ],
                      "dkim_aligned_pass": true
                    },
                    "arc_instances": 0,
                    "arc_cv": [],
                    "message_id_domain": "app.example.com",
                    "sending_software": "Example Mailer 4.2",
                    "unsubscribe": {
                      "present": false,
                      "https": false,
                      "mailto": false,
                      "one_click": false
                    },
                    "spam": [],
                    "public_ips": [],
                    "verdict": "dmarc_pass"
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ],
        "x-dnssuper-tool": "email-header-analyzer",
        "x-dnssuper-price": "Free; any API key works and nothing is charged. What you paste is processed in memory and never stored.",
        "x-dnssuper-cache": "Never cached; every call runs again.",
        "x-dnssuper-mcp": {
          "tool": "analyze_email_headers",
          "example": "DMARC passed: the receiver authenticated this message as coming from example.com. It took 3 hops in 3 seconds.\nVerdict: DMARC pass (receiver mx.example.net)\nPath: 3 hops in 3 seconds; entered at mx.example.net\nSPF: pass for example.com (aligned) | DKIM: pass for example.com (aligned) | DMARC: pass\n1 check passed\nFree | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/dkim-verify": {
      "post": {
        "tags": [
          "Email"
        ],
        "summary": "DKIM signature verifier",
        "description": "Each DKIM signature of a pasted or uploaded message, verified against the key in DNS, and its ARC chain. Free; any API key works and nothing is charged. What you paste is processed in memory and never stored. Never cached; every call runs again.",
        "operationId": "run_dkim_verifier",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/DkimVerifierParams"
              },
              "example": {
                "message": "DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=example.com;\r\n i=@example.com; q=dns/txt; s=ed; t=1763110800; x=4070908800; h=from :\r\n to : subject : date : message-id : mime-version : content-type;\r\n bh=KJnAeuZ/knrZy8sYwyJ5zN3YozO4yAxReYpZtfCc18U=;\r\n b=wVbKea6cK4XzAtcMVChX4BMxpO61V9ZdTAh+rQi72MJ+hQggliGvoyZaqcpT6GhQK0EqN\r\n n3Du0RQPmGjL9pxDQ==\r\nDKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=example.com;\r\n i=@example.com; q=dns/txt; s=rsa2048; t=1763110800; x=4070908800;\r\n h=from : to : subject : date : message-id : mime-version :\r\n content-type; bh=KJnAeuZ/knrZy8sYwyJ5zN3YozO4yAxReYpZtfCc18U=;\r\n b=3haMpeyyAnS2wSC3nabIS54vU1w+fAORTeCAw+Kc2sxpBFSwfxqcQBa6gnLPPprFgXEfz\r\n IzCqxGFrzR2PungMXn7CAN7eL7Vpci7n6hodboSzjWoFUCivGXw5j9mgluQPn6ci9YiR0+6\r\n RROLPhkifYNZsZ4J1QwWEfanNLegJfwX8VAxFE5eqLlsz5gnEdPAYPyZwFO2hJQc9xd9n9Q\r\n XYb74vYJVtqADaIO4Igb0BpBqLp5sZayR9jW6+eAiaJs6XiZEMAkHq/she+sC9bguEs35OK\r\n UyVttcbHspDfTHInv0XNyJ5yPcRMrR/A8/XFrQGeKbclLnHbxGfEqRBlkDmQ==\r\nFrom: Alice Example <alice@example.com>\r\nTo: Bob Example <bob@example.net>\r\nSubject: Quarterly figures\r\nDate: Fri, 14 Nov 2026 09:00:00 +0000\r\nMessage-ID: <20261114090000.4711@example.com>\r\nMIME-Version: 1.0\r\nContent-Type: text/plain; charset=utf-8\r\n\r\nHello Bob,\r\n\r\nHere are the figures  for the quarter.   Thanks.\r\n\r\nAlice\r\n",
                "verify_arc": true
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DkimVerifierResponse"
                },
                "example": {
                  "tool": "dkim-verifier",
                  "target": "",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 0,
                  "summary": "2 of 2 DKIM signatures verified, including one that aligns with the From domain example.com.",
                  "findings": [
                    {
                      "id": "arc.none",
                      "severity": "info",
                      "title": "No ARC headers",
                      "detail": "",
                      "fix": "Nothing to do; ARC is added only by forwarders and mailing lists."
                    },
                    {
                      "id": "dkim_signature.verified",
                      "severity": "pass",
                      "title": "A DKIM signature verified",
                      "detail": "d=example.com s=ed; d=example.com s=rsa2048",
                      "fix": "Nothing to do."
                    }
                  ],
                  "data": {
                    "message_bytes": 1309,
                    "line_endings_converted": false,
                    "from_domain": "example.com",
                    "signatures": [
                      {
                        "index": 0,
                        "domain": "example.com",
                        "selector": "ed",
                        "algorithm": "ed25519-sha256",
                        "canonicalization": "relaxed/relaxed",
                        "signed_headers": [
                          "from",
                          "to",
                          "subject",
                          "date",
                          "message-id",
                          "mime-version",
                          "content-type"
                        ],
                        "identity_domain": "example.com",
                        "signed_at": "2025-11-14T09:00:00Z",
                        "expires_at": "2099-01-01T00:00:00Z",
                        "key": {
                          "record_name": "ed._domainkey.example.com",
                          "status": "found",
                          "key_type": "ed25519",
                          "key_bits": 256,
                          "testing": false
                        },
                        "body_hash_ok": true,
                        "signature_ok": true,
                        "result": "pass",
                        "reason": "Verified with the key at ed._domainkey.example.com.",
                        "aligned_with_from": true
                      },
                      {
                        "index": 1,
                        "domain": "example.com",
                        "selector": "rsa2048",
                        "algorithm": "rsa-sha256",
                        "canonicalization": "relaxed/relaxed",
                        "signed_headers": [
                          "from",
                          "to",
                          "subject",
                          "date",
                          "message-id",
                          "mime-version",
                          "content-type"
                        ],
                        "identity_domain": "example.com",
                        "signed_at": "2025-11-14T09:00:00Z",
                        "expires_at": "2099-01-01T00:00:00Z",
                        "key": {
                          "record_name": "rsa2048._domainkey.example.com",
                          "status": "found",
                          "key_type": "rsa",
                          "key_bits": 2048,
                          "testing": false
                        },
                        "body_hash_ok": true,
                        "signature_ok": true,
                        "result": "pass",
                        "reason": "Verified with the key at rsa2048._domainkey.example.com.",
                        "aligned_with_from": true
                      }
                    ],
                    "unverified_signatures": 0,
                    "arc": {
                      "chain": "none",
                      "structure_ok": true,
                      "sets": []
                    },
                    "aligned_pass": true
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ],
        "x-dnssuper-tool": "dkim-verifier",
        "x-dnssuper-price": "Free; any API key works and nothing is charged. What you paste is processed in memory and never stored.",
        "x-dnssuper-cache": "Never cached; every call runs again.",
        "x-dnssuper-mcp": {
          "tool": "verify_dkim_signature",
          "example": "2 of 2 DKIM signatures verified, including one that aligns with the From domain example.com.\nFrom domain: example.com (an aligned signature passed)\nd=example.com s=ed ed25519-sha256: pass (aligned)\nd=example.com s=rsa2048 rsa-sha256: pass (aligned)\n- info: No ARC headers\n1 check passed\nFree | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/http": {
      "get": {
        "tags": [
          "Website"
        ],
        "summary": "HTTP and security headers",
        "description": "How a site answers on http and https with and without www, its redirects, security headers, HSTS, CSP and cookies, graded. Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 15 minutes; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_security_headers",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "A domain or URL; only the site (scheme and host) is used.",
              "examples": [
                "example.com"
              ],
              "x-widget": "url",
              "x-mono": true,
              "title": "Url"
            },
            "description": "A domain or URL; only the site (scheme and host) is used."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SecurityHeadersResponse"
                },
                "example": {
                  "tool": "security-headers",
                  "target": "https://example.com/",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 2,
                  "summary": "Grade A (100/100) for example.com. HTTPS, redirects and the main security headers are in place.",
                  "score": 100,
                  "findings": [],
                  "data": {
                    "host": "example.com",
                    "alternate_host": "www.example.com",
                    "reachable": true,
                    "no_website": false,
                    "entry_points": [
                      {
                        "start_url": "http://example.com/",
                        "final_url": "https://www.example.com/",
                        "final_status": 200,
                        "hops": [
                          {
                            "url": "http://example.com/",
                            "status": 301,
                            "location": "https://example.com/",
                            "elapsed_ms": 12,
                            "cookie_names": [],
                            "kind": "http"
                          },
                          {
                            "url": "https://example.com/",
                            "status": 301,
                            "location": "https://www.example.com/",
                            "elapsed_ms": 12,
                            "cookie_names": [],
                            "kind": "http"
                          },
                          {
                            "url": "https://www.example.com/",
                            "status": 200,
                            "elapsed_ms": 12,
                            "cookie_names": [
                              "__Host-session"
                            ],
                            "kind": "http"
                          }
                        ],
                        "outcome": "ok"
                      },
                      {
                        "start_url": "https://example.com/",
                        "final_url": "https://www.example.com/",
                        "final_status": 200,
                        "hops": [
                          {
                            "url": "https://example.com/",
                            "status": 301,
                            "location": "https://www.example.com/",
                            "elapsed_ms": 12,
                            "cookie_names": [],
                            "kind": "http"
                          },
                          {
                            "url": "https://www.example.com/",
                            "status": 200,
                            "elapsed_ms": 12,
                            "cookie_names": [
                              "__Host-session"
                            ],
                            "kind": "http"
                          }
                        ],
                        "outcome": "ok"
                      },
                      {
                        "start_url": "http://www.example.com/",
                        "final_url": "https://www.example.com/",
                        "final_status": 200,
                        "hops": [
                          {
                            "url": "http://www.example.com/",
                            "status": 301,
                            "location": "https://www.example.com/",
                            "elapsed_ms": 12,
                            "cookie_names": [],
                            "kind": "http"
                          },
                          {
                            "url": "https://www.example.com/",
                            "status": 200,
                            "elapsed_ms": 12,
                            "cookie_names": [
                              "__Host-session"
                            ],
                            "kind": "http"
                          }
                        ],
                        "outcome": "ok"
                      },
                      {
                        "start_url": "https://www.example.com/",
                        "final_url": "https://www.example.com/",
                        "final_status": 200,
                        "hops": [
                          {
                            "url": "https://www.example.com/",
                            "status": 200,
                            "elapsed_ms": 12,
                            "cookie_names": [
                              "__Host-session"
                            ],
                            "kind": "http"
                          }
                        ],
                        "outcome": "ok"
                      }
                    ],
                    "primary_url": "https://www.example.com/",
                    "primary_status": 200,
                    "http_version": "HTTP/1.1",
                    "headers": {
                      "strict-transport-security": "max-age=63072000; includeSubDomains; preload",
                      "content-security-policy": "default-src 'self'; script-src 'self' 'nonce-r4nd0m'; object-src 'none'; base-uri 'none'; frame-ancestors 'self'",
                      "x-frame-options": "SAMEORIGIN",
                      "x-content-type-options": "nosniff",
                      "referrer-policy": "strict-origin-when-cross-origin",
                      "permissions-policy": "camera=(), microphone=(), geolocation=()",
                      "cross-origin-opener-policy": "same-origin",
                      "server": "nginx",
                      "alt-svc": "h3=\":443\"; ma=86400"
                    },
                    "hsts": {
                      "present": true,
                      "max_age": 63072000,
                      "include_subdomains": true,
                      "preload": true,
                      "problems": []
                    },
                    "preload": {
                      "eligible": true,
                      "applicable": true,
                      "missing": []
                    },
                    "csp": [
                      {
                        "source": "header",
                        "report_only": false,
                        "directives": {
                          "default-src": [
                            "'self'"
                          ],
                          "script-src": [
                            "'self'",
                            "'nonce-r4nd0m'"
                          ],
                          "object-src": [
                            "'none'"
                          ],
                          "base-uri": [
                            "'none'"
                          ],
                          "frame-ancestors": [
                            "'self'"
                          ]
                        },
                        "weaknesses": [],
                        "upgrade_insecure_requests": false
                      }
                    ],
                    "framing": "frame-ancestors",
                    "referrer_policy": "strict-origin-when-cross-origin",
                    "permissions_policy": [
                      "camera",
                      "microphone",
                      "geolocation"
                    ],
                    "coop": "same-origin",
                    "cookies": [
                      {
                        "name": "__Host-session",
                        "path": "/",
                        "secure": true,
                        "http_only": true,
                        "same_site": "lax",
                        "session": true,
                        "prefix_ok": true,
                        "over_https": true
                      }
                    ],
                    "disclosed": [],
                    "http2": true,
                    "http3_advertised": true
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "security-headers",
        "x-dnssuper-price": "Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for up to 15 minutes; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "check_http",
          "example": "Grade A (100/100) for example.com. HTTPS, redirects and the main security headers are in place.\nScore: 100/100\nhttp://example.com/ -> 301 -> 301 -> https://www.example.com/ 200\nhttps://example.com/ -> 301 -> https://www.example.com/ 200\nhttp://www.example.com/ -> 301 -> https://www.example.com/ 200\nhttps://www.example.com/ 200\nPresent: HSTS, CSP, X-Content-Type-Options, Referrer-Policy, Permissions-Policy, framing protection; HTTP/2, HTTP/3 advertised\nNo issues found.\nCredits: 2 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/seo": {
      "get": {
        "tags": [
          "Website"
        ],
        "summary": "Technical SEO audit",
        "description": "Indexability, canonical, content, links, sitemap and redirects of a page, graded; optionally compared with the rendered page. Costs 3 credits per call; cached answers cost the same. Rendered mode costs 8 credits and runs as a job: reserved when it starts, charged when it finishes, and only 3 if the browser part fails. Calls that fail upstream (502) and failed runs are free. Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_seo_audit",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "A page URL or a domain; a domain means its home page.",
              "examples": [
                "example.com"
              ],
              "x-widget": "url",
              "x-mono": true,
              "title": "Url"
            },
            "description": "A page URL or a domain; a domain means its home page."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SeoAuditResponse"
                },
                "example": {
                  "tool": "seo-audit",
                  "target": "https://example.com/",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 3,
                  "summary": "example.com gets an A for technical SEO. Nothing stops search engines from indexing it.",
                  "score": 100,
                  "findings": [],
                  "data": {
                    "url": "https://example.com/",
                    "final_url": "https://example.com/",
                    "status": 200,
                    "hops": [
                      {
                        "url": "https://example.com/",
                        "status": 200,
                        "kind": "http"
                      }
                    ],
                    "html_bytes": 1901,
                    "truncated": false,
                    "elapsed_ms": 12,
                    "indexability": {
                      "indexable": true,
                      "meta_robots": [],
                      "x_robots_tag": [],
                      "robots": {
                        "status": "ok",
                        "googlebot_allowed": true,
                        "rule": "Allow: /",
                        "line": 2
                      }
                    },
                    "canonical": {
                      "href": "https://example.com/",
                      "count": 1,
                      "absolute": true,
                      "target_status": 200,
                      "self_referencing": true,
                      "cross_domain": false
                    },
                    "content": {
                      "title": "Example Widgets: handmade widgets since 1999",
                      "title_length": 44,
                      "description": "Handmade widgets in every colour, shipped across Europe. Browse the catalogue, read the care guide and order online.",
                      "description_length": 116,
                      "h1": [
                        "Handmade widgets"
                      ],
                      "headings": [
                        {
                          "level": 1,
                          "text": "Handmade widgets"
                        },
                        {
                          "level": 2,
                          "text": "Caring for your widget"
                        }
                      ],
                      "lang": "en",
                      "viewport": "width=device-width, initial-scale=1",
                      "text_chars": 754
                    },
                    "links": {
                      "images": 1,
                      "images_missing_alt": 0,
                      "internal": 3,
                      "external": 1,
                      "nofollow": 1
                    },
                    "sitemap": {
                      "source": "robots",
                      "files": [
                        {
                          "url": "https://example.com/sitemap.xml",
                          "status": 200,
                          "kind": "urlset",
                          "urls": 2,
                          "gz": false,
                          "truncated": false
                        }
                      ],
                      "url_count": 2,
                      "listed": true,
                      "truncated": false
                    },
                    "presence": {
                      "favicon": true,
                      "jsonld": true,
                      "microdata": false,
                      "rdfa": false,
                      "hreflang": false,
                      "open_graph": true,
                      "twitter_card": true
                    },
                    "redirects": {
                      "checked": true,
                      "consistent": true,
                      "https_upgrade": true
                    },
                    "js": {
                      "likely_client_rendered": false,
                      "text_chars": 754,
                      "script_tags": 1,
                      "inline_script_bytes": 117
                    }
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "seo-audit",
        "x-dnssuper-price": "Costs 3 credits per call; cached answers cost the same. Rendered mode costs 8 credits and runs as a job: reserved when it starts, charged when it finishes, and only 3 if the browser part fails. Calls that fail upstream (502) and failed runs are free.",
        "x-dnssuper-cache": "Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "audit_seo",
          "example": "example.com gets an A for technical SEO. Nothing stops search engines from indexing it.\nScore: 100/100\nIndexable: yes (robots.txt allows Googlebot)\nTitle: \"Example Widgets: handmade widgets since 1999\" (44 characters)\nCanonical: https://example.com/ (this page)\nSitemap: 2 URLs in 1 file, listed in robots.txt; this page is listed\nRedirects: every entry point ends on the same address\nNo issues found.\nCredits: 3 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      },
      "post": {
        "tags": [
          "Website"
        ],
        "summary": "Technical SEO audit (rendered)",
        "description": "Indexability, canonical, content, links, sitemap and redirects of a page, graded; optionally compared with the rendered page. With `rendered: true` this runs as a job: the answer is a 202 with the job's links. Without it, use `GET /v1/seo`. Costs 3 credits per call; cached answers cost the same. Rendered mode costs 8 credits and runs as a job: reserved when it starts, charged when it finishes, and only 3 if the browser part fails. Calls that fail upstream (502) and failed runs are free.",
        "operationId": "run_seo_audit_rendered",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/SeoAuditParams"
              },
              "example": {
                "url": "https://www.example.com/",
                "rendered": true
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobStartResponse"
                },
                "example": {
                  "job_id": "28599f0b-c508-5837-9150-ac104d674fcd",
                  "status": "queued",
                  "total": 1,
                  "credits_reserved": 8,
                  "duplicates_removed": 0,
                  "job_url": "https://api.dnssuper.localhost/v1/jobs/28599f0b-c508-5837-9150-ac104d674fcd",
                  "items_url": "https://api.dnssuper.localhost/v1/jobs/28599f0b-c508-5837-9150-ac104d674fcd/items",
                  "events_url": "https://api.dnssuper.localhost/v1/jobs/28599f0b-c508-5837-9150-ac104d674fcd/events"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "seo-audit",
        "x-dnssuper-price": "Costs 3 credits per call; cached answers cost the same. Rendered mode costs 8 credits and runs as a job: reserved when it starts, charged when it finishes, and only 3 if the browser part fails. Calls that fail upstream (502) and failed runs are free.",
        "x-dnssuper-cache": "Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "audit_seo",
          "example": "www.example.com gets a C for technical SEO. No h1 heading.\nScore: 67/100\nIndexable: yes (robots.txt allows Googlebot)\nTitle: \"Widget shop\" (11 characters)\nCanonical: https://www.example.com/ (this page)\nSitemap: 1 URL in 1 file, at /sitemap.xml; this page is listed\nRedirects: every entry point ends on the same address\nRendered: 4 changes (title, description, h1, text_chars); text 0 -> 395 characters\n- warn: The title is very short or long. Fix: Aim for 30 to 60 characters.\n- warn: No h1 heading. Fix: Add one h1 that says what the page is about.\n- warn: The page may need JavaScript to show its content. Fix: Render the main content on the server.\n- warn: Content appears only after JavaScript runs. Fix: Render the main content on the server.\n+5 more findings (pass detail='full' to see all)\nCredits: 8 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        },
        "x-dnssuper-variant": "rendered"
      }
    },
    "/v1/structured-data": {
      "get": {
        "tags": [
          "Website"
        ],
        "summary": "Structured data and hreflang",
        "description": "JSON-LD, microdata and RDFa items on a page checked against schema.org rules, and hreflang alternates. Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_structured_data_validator",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "A page URL or a domain; a domain means its home page.",
              "examples": [
                "example.com"
              ],
              "x-widget": "url",
              "x-mono": true,
              "title": "Url"
            },
            "description": "A page URL or a domain; a domain means its home page."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StructuredDataValidatorResponse"
                },
                "example": {
                  "tool": "structured-data-validator",
                  "target": "https://example.com/",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 2,
                  "summary": "example.com has 3 valid structured data items (Organization, Product and BreadcrumbList). Search engines decide whether to show rich results.",
                  "findings": [
                    {
                      "id": "hreflang.none",
                      "severity": "info",
                      "title": "No hreflang alternates",
                      "detail": "",
                      "fix": "Nothing to do unless the site has other language versions."
                    },
                    {
                      "id": "structured_data.valid",
                      "severity": "pass",
                      "title": "The structured data is valid",
                      "detail": "",
                      "fix": "Nothing to do; search engines decide whether to show rich results."
                    }
                  ],
                  "data": {
                    "url": "https://example.com/",
                    "final_url": "https://example.com/",
                    "status": 200,
                    "truncated": false,
                    "items": [
                      {
                        "syntax": "json-ld",
                        "types": [
                          "Organization"
                        ],
                        "id": "https://example.com/#org",
                        "properties": [
                          "logo",
                          "name",
                          "sameAs",
                          "url"
                        ],
                        "problems": [],
                        "rule": "Organization"
                      },
                      {
                        "syntax": "json-ld",
                        "types": [
                          "Product"
                        ],
                        "properties": [
                          "brand",
                          "description",
                          "image",
                          "name",
                          "offers",
                          "sku"
                        ],
                        "problems": [],
                        "rule": "Product"
                      },
                      {
                        "syntax": "json-ld",
                        "types": [
                          "BreadcrumbList"
                        ],
                        "properties": [
                          "itemListElement"
                        ],
                        "problems": [],
                        "rule": "BreadcrumbList"
                      }
                    ],
                    "jsonld_errors": [],
                    "counts": {
                      "jsonld": 3,
                      "microdata": 0,
                      "rdfa": 0
                    },
                    "hreflang": {
                      "sources": {
                        "html": 0,
                        "header": 0,
                        "sitemap": 0
                      },
                      "alternates": [],
                      "self_reference": false,
                      "x_default": false,
                      "invalid_codes": [],
                      "conflicts": [],
                      "relative": [],
                      "limit_reached": false
                    }
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "structured-data-validator",
        "x-dnssuper-price": "Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "validate_structured_data",
          "example": "example.com has 3 valid structured data items (Organization, Product and BreadcrumbList). Search engines decide whether to show rich results.\nItems: 3 (JSON-LD 3, microdata 0, RDFa 0)\nOrganization (json-ld): no problems\nProduct (json-ld): no problems\nBreadcrumbList (json-ld): no problems\nhreflang: none\n- info: No hreflang alternates\n1 check passed\nCredits: 2 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/accessibility": {
      "get": {
        "tags": [
          "Website"
        ],
        "summary": "Basic accessibility",
        "description": "Basic automated accessibility checks of a page; optionally colour contrast and axe-core rules in a browser. Costs 2 credits per call; cached answers cost the same. Contrast mode costs 5 credits and runs as a job: reserved when it starts, charged when it finishes, and only 2 if the browser part fails. Calls that fail upstream (502) and failed runs are free. Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_accessibility_checker",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "A page URL or a domain; a domain means its home page.",
              "examples": [
                "example.com"
              ],
              "x-widget": "url",
              "x-mono": true,
              "title": "Url"
            },
            "description": "A page URL or a domain; a domain means its home page."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AccessibilityCheckerResponse"
                },
                "example": {
                  "tool": "accessibility-checker",
                  "target": "https://example.com/order",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 2,
                  "summary": "7 checks found problems on example.com/order. Automated checks find only some accessibility problems; this is a starting point, not a compliance certificate.",
                  "findings": [
                    {
                      "id": "a11y.img_alt_missing",
                      "severity": "fail",
                      "title": "Images without alt text",
                      "detail": "4 images have no text alternative.",
                      "fix": "Add alt text; use alt=\"\" for decorative images."
                    },
                    {
                      "id": "a11y.form_label_missing",
                      "severity": "fail",
                      "title": "Form fields without labels",
                      "detail": "5 form fields have no label.",
                      "fix": "Give each field a <label> or aria-label."
                    },
                    {
                      "id": "a11y.link_name_missing",
                      "severity": "fail",
                      "title": "Links without text",
                      "detail": "2 links have no text a screen reader can announce.",
                      "fix": "Give each link text or an aria-label."
                    },
                    {
                      "id": "a11y.button_name_missing",
                      "severity": "fail",
                      "title": "Buttons without text",
                      "detail": "2 buttons have no text a screen reader can announce.",
                      "fix": "Give each button text or an aria-label."
                    },
                    {
                      "id": "a11y.duplicate_id_referenced",
                      "severity": "warn",
                      "title": "A referenced id is used more than once",
                      "detail": "2 elements share an id that labels or controls refer to.",
                      "fix": "Make ids unique."
                    },
                    {
                      "id": "a11y.positive_tabindex",
                      "severity": "warn",
                      "title": "Elements use a positive tabindex",
                      "detail": "1 elements have a tabindex above 0.",
                      "fix": "Use tabindex 0 or -1 and the document order."
                    },
                    {
                      "id": "a11y.frame_title_missing",
                      "severity": "warn",
                      "title": "A frame has no title",
                      "detail": "1 frames have no title.",
                      "fix": "Add a title to each iframe."
                    }
                  ],
                  "data": {
                    "url": "https://example.com/order",
                    "final_url": "https://example.com/order",
                    "status": 200,
                    "mode": "static",
                    "disclaimer": "Automated checks find only some accessibility problems; this is a starting point, not a compliance certificate.",
                    "truncated": false,
                    "counts": {
                      "images": 4,
                      "images_missing_alt": 4,
                      "fields": 5,
                      "unlabelled_fields": 5,
                      "links": 2,
                      "unnamed_links": 2,
                      "buttons": 2,
                      "unnamed_buttons": 2,
                      "headings": 1
                    },
                    "headings": [
                      {
                        "level": 1,
                        "text": "Order a widget"
                      }
                    ],
                    "instances": {
                      "a11y.img_alt_missing": [
                        {
                          "selector": "body > main > img",
                          "snippet": "<img src=\"/images/blue.png\">"
                        },
                        {
                          "selector": "body > main > p > a:nth-of-type(1) > img",
                          "snippet": "<img src=\"/images/cart.png\">"
                        },
                        {
                          "selector": "body > main > input",
                          "snippet": "<input type=\"image\" src=\"/images/go.png\">"
                        },
                        {
                          "selector": "body > main > div",
                          "snippet": "<div role=\"img\" class=\"logo\">"
                        }
                      ],
                      "a11y.form_label_missing": [
                        {
                          "selector": "body > main > form > input:nth-of-type(1)",
                          "snippet": "<input type=\"text\" name=\"name\" placeholder=\"Your name\">"
                        },
                        {
                          "selector": "input#email",
                          "snippet": "<input id=\"email\" type=\"email\" name=\"email\">"
                        },
                        {
                          "selector": "input#hint",
                          "snippet": "<input id=\"hint\" type=\"checkbox\" aria-describedby=\"hint\">"
                        },
                        {
                          "selector": "body > main > form > textarea",
                          "snippet": "<textarea name=\"notes\">"
                        },
                        {
                          "selector": "body > main > form > select",
                          "snippet": "<select name=\"colour\">"
                        }
                      ],
                      "a11y.link_name_missing": [
                        {
                          "selector": "body > main > p > a:nth-of-type(1)",
                          "snippet": "<a href=\"/cart\">"
                        },
                        {
                          "selector": "body > main > p > a:nth-of-type(2)",
                          "snippet": "<a href=\"/help\">"
                        }
                      ],
                      "a11y.button_name_missing": [
                        {
                          "selector": "body > main > form > button",
                          "snippet": "<button type=\"submit\">"
                        },
                        {
                          "selector": "body > main > form > div",
                          "snippet": "<div role=\"button\" tabindex=\"3\">"
                        }
                      ],
                      "a11y.duplicate_id_referenced": [
                        {
                          "selector": "span#hint",
                          "snippet": "<span id=\"hint\">"
                        },
                        {
                          "selector": "input#hint",
                          "snippet": "<input id=\"hint\" type=\"checkbox\" aria-describedby=\"hint\">"
                        }
                      ],
                      "a11y.positive_tabindex": [
                        {
                          "selector": "body > main > form > div",
                          "snippet": "<div role=\"button\" tabindex=\"3\">"
                        }
                      ],
                      "a11y.frame_title_missing": [
                        {
                          "selector": "body > main > iframe",
                          "snippet": "<iframe src=\"https://www.example.org/embed\">"
                        }
                      ]
                    }
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "accessibility-checker",
        "x-dnssuper-price": "Costs 2 credits per call; cached answers cost the same. Contrast mode costs 5 credits and runs as a job: reserved when it starts, charged when it finishes, and only 2 if the browser part fails. Calls that fail upstream (502) and failed runs are free.",
        "x-dnssuper-cache": "Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "audit_accessibility",
          "example": "7 checks found problems on example.com/order. Automated checks find only some accessibility problems; this is a starting point, not a compliance certificate.\nImages: 4 (4 without alt); fields: 5 (5 unlabelled); links: 2 (2 unnamed); buttons: 2 (2 unnamed)\nHeadings: 1\nImage without alt: body > main > img <img src=\"/images/blue.png\">\nField without label: body > main > form > input:nth-of-type(1) <input type=\"text\" name=\"name\" placeholder=\"Your name\">\nLink without a name: body > main > p > a:nth-of-type(1) <a href=\"/cart\">\nAutomated checks find only some problems; this is a starting point, not a certificate.\n- fail: Images without alt text. Fix: Add alt text; use alt=\"\" for decorative images.\n- fail: Form fields without labels. Fix: Give each field a <label> or aria-label.\n- fail: Links without text. Fix: Give each link text or an aria-label.\n- fail: Buttons without text. Fix: Give each button text or an aria-label.\n+3 more findings (pass detail='full' to see all)\nCredits: 2 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      },
      "post": {
        "tags": [
          "Website"
        ],
        "summary": "Basic accessibility (contrast)",
        "description": "Basic automated accessibility checks of a page; optionally colour contrast and axe-core rules in a browser. With `contrast: true` this runs as a job: the answer is a 202 with the job's links. Without it, use `GET /v1/accessibility`. Costs 2 credits per call; cached answers cost the same. Contrast mode costs 5 credits and runs as a job: reserved when it starts, charged when it finishes, and only 2 if the browser part fails. Calls that fail upstream (502) and failed runs are free.",
        "operationId": "run_accessibility_checker_contrast",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/AccessibilityCheckerParams"
              },
              "example": {
                "url": "https://www.example.com/",
                "contrast": true
              }
            }
          }
        },
        "responses": {
          "202": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobStartResponse"
                },
                "example": {
                  "job_id": "d91497b9-6183-589f-9d00-50d6766835d8",
                  "status": "queued",
                  "total": 1,
                  "credits_reserved": 5,
                  "duplicates_removed": 0,
                  "job_url": "https://api.dnssuper.localhost/v1/jobs/d91497b9-6183-589f-9d00-50d6766835d8",
                  "items_url": "https://api.dnssuper.localhost/v1/jobs/d91497b9-6183-589f-9d00-50d6766835d8/items",
                  "events_url": "https://api.dnssuper.localhost/v1/jobs/d91497b9-6183-589f-9d00-50d6766835d8/events"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "accessibility-checker",
        "x-dnssuper-price": "Costs 2 credits per call; cached answers cost the same. Contrast mode costs 5 credits and runs as a job: reserved when it starts, charged when it finishes, and only 2 if the browser part fails. Calls that fail upstream (502) and failed runs are free.",
        "x-dnssuper-cache": "Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "audit_accessibility",
          "example": "3 checks found problems on www.example.com. Automated checks find only some accessibility problems; this is a starting point, not a compliance certificate.\nImages: 1 (1 without alt); fields: 0 (0 unlabelled); links: 0 (0 unnamed); buttons: 0 (0 unnamed)\nHeadings: 1\nImage without alt: body > main > img <img src=\"data:...\" width=\"1\" height=\"1\">\nLow contrast: main > .faint <p class=\"faint\">This grey text is hard to read.</p>\naxe-core 4.14.0: 3 rules failed, 0 need review\nAutomated checks find only some problems; this is a starting point, not a certificate.\n- fail: Images without alt text. Fix: Add alt text; use alt=\"\" for decorative images.\n- fail: Some text has too little contrast. Fix: Darken the text or lighten the background to reach 4.5 to 1.\n- fail: axe-core found more problems. Fix: Fix the listed rules.\nCredits: 5 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        },
        "x-dnssuper-variant": "contrast"
      }
    },
    "/v1/standard-files": {
      "get": {
        "tags": [
          "Website"
        ],
        "summary": "Standard files",
        "description": "A site's security.txt, ads.txt, app-ads.txt and humans.txt, mixed content, compression and caching headers. Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 15 minutes; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_security_txt_checker",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "A domain or URL; only the site (scheme and host) is used.",
              "examples": [
                "example.com"
              ],
              "x-widget": "url",
              "x-mono": true,
              "title": "Url"
            },
            "description": "A domain or URL; only the site (scheme and host) is used."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SecurityTxtCheckerResponse"
                },
                "example": {
                  "tool": "security-txt-checker",
                  "target": "https://example.com/",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 1,
                  "summary": "security.txt is valid and expires in 198 days. ads.txt lists 3 sellers.",
                  "findings": [
                    {
                      "id": "security_txt.signature_not_verified",
                      "severity": "info",
                      "title": "security.txt is signed; we didn't verify the signature",
                      "detail": "",
                      "fix": "Nothing to do."
                    }
                  ],
                  "data": {
                    "host": "example.com",
                    "security_txt": {
                      "url": "https://example.com/.well-known/security.txt",
                      "location": "well-known",
                      "status": 200,
                      "content_type": "text/plain",
                      "https": true,
                      "signed": true,
                      "fields": {
                        "Contact": [
                          "mailto:security@example.com",
                          "https://example.com/security"
                        ],
                        "Expires": [
                          "2027-06-01T00:00:00Z"
                        ],
                        "Encryption": [
                          "https://example.com/pgp-key.txt"
                        ],
                        "Preferred-Languages": [
                          "en, fr"
                        ],
                        "Canonical": [
                          "https://example.com/.well-known/security.txt"
                        ],
                        "Policy": [
                          "https://example.com/security-policy"
                        ]
                      },
                      "expires": "2027-06-01T00:00:00+00:00",
                      "expires_in_days": 198,
                      "invalid_lines": []
                    },
                    "ads_txt": {
                      "url": "https://example.com/ads.txt",
                      "present": true,
                      "records": 3,
                      "direct": 2,
                      "reseller": 1,
                      "malformed_lines": [],
                      "variables": {
                        "contact": [
                          "ads@example.com"
                        ]
                      }
                    },
                    "app_ads_txt": {
                      "url": "https://example.com/app-ads.txt",
                      "present": true,
                      "records": 1,
                      "direct": 1,
                      "reseller": 0,
                      "malformed_lines": [],
                      "variables": {}
                    },
                    "humans_txt": true,
                    "page_url": "https://example.com/",
                    "mixed_content": [],
                    "compression": [],
                    "caching": [
                      {
                        "url": "https://example.com/",
                        "type": "text/html",
                        "cache_control": "max-age=300",
                        "etag": true,
                        "last_modified": false,
                        "encoding": "gzip",
                        "bytes": 2135,
                        "wire_bytes": 226
                      },
                      {
                        "url": "https://example.com/app.js",
                        "type": "text/javascript",
                        "cache_control": "public, max-age=31536000, immutable",
                        "etag": false,
                        "last_modified": false,
                        "encoding": "gzip",
                        "bytes": 2770,
                        "wire_bytes": 74
                      },
                      {
                        "url": "https://example.com/style.css",
                        "type": "text/css",
                        "cache_control": "public, max-age=31536000",
                        "etag": false,
                        "last_modified": false,
                        "encoding": "br",
                        "bytes": 3012,
                        "wire_bytes": 34
                      }
                    ]
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "security-txt-checker",
        "x-dnssuper-price": "Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for up to 15 minutes; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "check_standard_files",
          "example": "security.txt is valid and expires in 198 days. ads.txt lists 3 sellers.\nsecurity.txt: /.well-known/security.txt, signed (not verified), expires in 198 days\nContact: mailto:security@example.com, https://example.com/security\nads.txt: 3 sellers (2 direct, 1 reseller); app-ads.txt: 1 seller (1 direct, 0 reseller)\nhumans.txt: yes\n- info: security.txt is signed; we didn't verify the signature\nCredits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/ai-crawlers": {
      "get": {
        "tags": [
          "Website"
        ],
        "summary": "AI crawler access",
        "description": "Which search, AI training and AI assistant crawlers robots.txt allows for a page, page directives and llms.txt. Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_ai_crawler_checker",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "A page URL or a domain; a domain means its home page.",
              "examples": [
                "example.com"
              ],
              "x-widget": "url",
              "x-mono": true,
              "title": "Url"
            },
            "description": "A page URL or a domain; a domain means its home page."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AiCrawlerCheckerResponse"
                },
                "example": {
                  "tool": "ai-crawler-checker",
                  "target": "https://example.com/blog/post",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 1,
                  "summary": "Search: mixed; AI training: mixed; AI assistants: mixed. robots.txt shows what a site asks for, not what crawlers do.",
                  "findings": [
                    {
                      "id": "ai_crawlers.robots_invalid",
                      "severity": "warn",
                      "title": "robots.txt has problems",
                      "detail": "Lines 16 aren't valid.",
                      "fix": "Fix the listed lines, serve it as text/plain and keep it under 500 KB."
                    },
                    {
                      "id": "ai_crawlers.search_blocked",
                      "severity": "warn",
                      "title": "Search engine crawlers are blocked",
                      "detail": "Blocked: Bingbot.",
                      "fix": "Allow search crawlers unless you want out of search results."
                    },
                    {
                      "id": "ai_crawlers.page_noindex",
                      "severity": "warn",
                      "title": "The page asks search engines not to index it",
                      "detail": "",
                      "fix": "Remove noindex if the page should appear in search."
                    },
                    {
                      "id": "ai_crawlers.training_blocked",
                      "severity": "info",
                      "title": "AI training crawlers are blocked",
                      "detail": "Blocked: GPTBot, CCBot.",
                      "fix": "Nothing to do if that's your choice."
                    },
                    {
                      "id": "ai_crawlers.retrieval_blocked",
                      "severity": "info",
                      "title": "AI assistant fetchers are blocked",
                      "detail": "Blocked: PerplexityBot.",
                      "fix": "Nothing to do if that's your choice."
                    },
                    {
                      "id": "ai_crawlers.noai_directive",
                      "severity": "info",
                      "title": "The page asks not to be used for AI",
                      "detail": "noai, GPTBot: noimageai.",
                      "fix": "Nothing to do; not every crawler honours noai."
                    },
                    {
                      "id": "llms_txt.missing",
                      "severity": "info",
                      "title": "No llms.txt",
                      "detail": "",
                      "fix": "Nothing to do; llms.txt is an optional proposal."
                    }
                  ],
                  "data": {
                    "url": "https://example.com/blog/post",
                    "robots_url": "https://example.com/robots.txt",
                    "robots_status": "ok",
                    "robots_http_status": 200,
                    "sitemaps": [
                      "https://example.com/sitemap.xml"
                    ],
                    "invalid_lines": [
                      16
                    ],
                    "crawlers": [
                      {
                        "token": "Googlebot",
                        "vendor": "Google",
                        "purpose": "search",
                        "user_triggered": false,
                        "allowed": true,
                        "reason": "rule",
                        "rule": "Allow: /",
                        "rule_line": 18,
                        "group_agents": [
                          "*"
                        ]
                      },
                      {
                        "token": "Bingbot",
                        "vendor": "Microsoft",
                        "purpose": "search",
                        "user_triggered": false,
                        "allowed": false,
                        "reason": "rule",
                        "rule": "Disallow: /",
                        "rule_line": 7,
                        "group_agents": [
                          "Bingbot"
                        ]
                      },
                      {
                        "token": "Applebot",
                        "vendor": "Apple",
                        "purpose": "search",
                        "user_triggered": false,
                        "allowed": true,
                        "reason": "rule",
                        "rule": "Allow: /",
                        "rule_line": 18,
                        "group_agents": [
                          "*"
                        ]
                      },
                      {
                        "token": "DuckDuckBot",
                        "vendor": "DuckDuckGo",
                        "purpose": "search",
                        "user_triggered": false,
                        "allowed": true,
                        "reason": "rule",
                        "rule": "Allow: /",
                        "rule_line": 18,
                        "group_agents": [
                          "*"
                        ]
                      },
                      {
                        "token": "Google-Extended",
                        "vendor": "Google",
                        "purpose": "training",
                        "user_triggered": false,
                        "allowed": true,
                        "reason": "rule",
                        "rule": "Allow: /",
                        "rule_line": 18,
                        "group_agents": [
                          "*"
                        ]
                      },
                      {
                        "token": "GPTBot",
                        "vendor": "OpenAI",
                        "purpose": "training",
                        "user_triggered": false,
                        "allowed": false,
                        "reason": "rule",
                        "rule": "Disallow: /",
                        "rule_line": 4,
                        "group_agents": [
                          "GPTBot",
                          "CCBot"
                        ]
                      },
                      {
                        "token": "ClaudeBot",
                        "vendor": "Anthropic",
                        "purpose": "training",
                        "user_triggered": false,
                        "allowed": true,
                        "reason": "rule",
                        "rule": "Allow: /",
                        "rule_line": 18,
                        "group_agents": [
                          "*"
                        ]
                      },
                      {
                        "token": "CCBot",
                        "vendor": "Common Crawl",
                        "purpose": "training",
                        "user_triggered": false,
                        "allowed": false,
                        "reason": "rule",
                        "rule": "Disallow: /",
                        "rule_line": 4,
                        "group_agents": [
                          "GPTBot",
                          "CCBot"
                        ]
                      },
                      {
                        "token": "Applebot-Extended",
                        "vendor": "Apple",
                        "purpose": "training",
                        "user_triggered": false,
                        "allowed": true,
                        "reason": "rule",
                        "rule": "Allow: /",
                        "rule_line": 18,
                        "group_agents": [
                          "*"
                        ]
                      },
                      {
                        "token": "Meta-ExternalAgent",
                        "vendor": "Meta",
                        "purpose": "training",
                        "user_triggered": false,
                        "allowed": true,
                        "reason": "rule",
                        "rule": "Allow: /",
                        "rule_line": 18,
                        "group_agents": [
                          "*"
                        ]
                      },
                      {
                        "token": "Amazonbot",
                        "vendor": "Amazon",
                        "purpose": "training",
                        "user_triggered": false,
                        "allowed": true,
                        "reason": "rule",
                        "rule": "Allow: /",
                        "rule_line": 18,
                        "group_agents": [
                          "*"
                        ]
                      },
                      {
                        "token": "OAI-SearchBot",
                        "vendor": "OpenAI",
                        "purpose": "retrieval",
                        "user_triggered": false,
                        "allowed": true,
                        "reason": "rule",
                        "rule": "Allow: /",
                        "rule_line": 13,
                        "group_agents": [
                          "OAI-SearchBot"
                        ]
                      },
                      {
                        "token": "ChatGPT-User",
                        "vendor": "OpenAI",
                        "purpose": "retrieval",
                        "user_triggered": true,
                        "allowed": true,
                        "reason": "rule",
                        "rule": "Allow: /",
                        "rule_line": 18,
                        "group_agents": [
                          "*"
                        ]
                      },
                      {
                        "token": "Claude-SearchBot",
                        "vendor": "Anthropic",
                        "purpose": "retrieval",
                        "user_triggered": false,
                        "allowed": true,
                        "reason": "rule",
                        "rule": "Allow: /",
                        "rule_line": 18,
                        "group_agents": [
                          "*"
                        ]
                      },
                      {
                        "token": "Claude-User",
                        "vendor": "Anthropic",
                        "purpose": "retrieval",
                        "user_triggered": true,
                        "allowed": true,
                        "reason": "rule",
                        "rule": "Allow: /",
                        "rule_line": 18,
                        "group_agents": [
                          "*"
                        ]
                      },
                      {
                        "token": "PerplexityBot",
                        "vendor": "Perplexity",
                        "purpose": "retrieval",
                        "user_triggered": false,
                        "allowed": false,
                        "reason": "rule",
                        "rule": "Disallow: /blog/",
                        "rule_line": 10,
                        "group_agents": [
                          "PerplexityBot"
                        ]
                      },
                      {
                        "token": "Perplexity-User",
                        "vendor": "Perplexity",
                        "purpose": "retrieval",
                        "user_triggered": true,
                        "allowed": true,
                        "reason": "rule",
                        "rule": "Allow: /",
                        "rule_line": 18,
                        "group_agents": [
                          "*"
                        ]
                      },
                      {
                        "token": "Meta-ExternalFetcher",
                        "vendor": "Meta",
                        "purpose": "retrieval",
                        "user_triggered": true,
                        "allowed": true,
                        "reason": "rule",
                        "rule": "Allow: /",
                        "rule_line": 18,
                        "group_agents": [
                          "*"
                        ]
                      },
                      {
                        "token": "DuckAssistBot",
                        "vendor": "DuckDuckGo",
                        "purpose": "retrieval",
                        "user_triggered": false,
                        "allowed": true,
                        "reason": "rule",
                        "rule": "Allow: /",
                        "rule_line": 18,
                        "group_agents": [
                          "*"
                        ]
                      },
                      {
                        "token": "MistralAI-User",
                        "vendor": "Mistral AI",
                        "purpose": "retrieval",
                        "user_triggered": true,
                        "allowed": true,
                        "reason": "rule",
                        "rule": "Allow: /",
                        "rule_line": 18,
                        "group_agents": [
                          "*"
                        ]
                      }
                    ],
                    "groups": {
                      "search": "mixed",
                      "training": "mixed",
                      "retrieval": "mixed"
                    },
                    "content_signals": [],
                    "page_directives": [
                      "noindex",
                      "noai",
                      "GPTBot: noimageai"
                    ],
                    "llms_txt": {
                      "url": "https://example.com/llms.txt",
                      "present": false,
                      "status": 404,
                      "starts_with_h1": false
                    },
                    "catalog_checked": "2026-11-15"
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "ai-crawler-checker",
        "x-dnssuper-price": "Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "check_ai_crawlers",
          "example": "Search: mixed; AI training: mixed; AI assistants: mixed. robots.txt shows what a site asks for, not what crawlers do.\nSearch: mixed (blocked: Bingbot)\nAI training: mixed (blocked: GPTBot, CCBot)\nAI assistants: mixed (blocked: PerplexityBot)\nrobots.txt: found, 1 invalid line\nPage directives: noindex, noai, GPTBot: noimageai\nllms.txt: none\n- warn: robots.txt has problems. Fix: Fix the listed lines, serve it as text/plain and keep it under 500 KB.\n- warn: Search engine crawlers are blocked. Fix: Allow search crawlers unless you want out of search results.\n- warn: The page asks search engines not to index it. Fix: Remove noindex if the page should appear in search.\n- info: AI training crawlers are blocked\n+3 more findings (pass detail='full' to see all)\nCredits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/social-preview": {
      "get": {
        "tags": [
          "Website"
        ],
        "summary": "Social preview",
        "description": "The Open Graph and X card tags of a page as platforms resolve them, and its preview image. Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_social_preview",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "A page URL or a domain; a domain means its home page.",
              "examples": [
                "example.com"
              ],
              "x-widget": "url",
              "x-mono": true,
              "title": "Url"
            },
            "description": "A page URL or a domain; a domain means its home page."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SocialPreviewResponse"
                },
                "example": {
                  "tool": "social-preview",
                  "target": "https://example.com/",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 1,
                  "summary": "Links to example.com show a full preview: a title, a description and a 1200 x 630 image.",
                  "findings": [],
                  "data": {
                    "url": "https://example.com/",
                    "final_url": "https://example.com/",
                    "og": {
                      "og:title": [
                        "Example Widgets"
                      ],
                      "og:description": [
                        "Widgets for every workshop, shipped worldwide."
                      ],
                      "og:image": [
                        "https://cdn.example.net/images/card.png"
                      ],
                      "og:url": [
                        "https://example.com/"
                      ],
                      "og:type": [
                        "website"
                      ],
                      "og:site_name": [
                        "Example"
                      ]
                    },
                    "twitter": {
                      "twitter:card": [
                        "summary_large_image"
                      ],
                      "twitter:site": [
                        "@example"
                      ]
                    },
                    "resolved": {
                      "title": "Example Widgets",
                      "description": "Widgets for every workshop, shipped worldwide.",
                      "image": "https://cdn.example.net/images/card.png",
                      "url": "https://example.com/",
                      "type": "website",
                      "site_name": "Example",
                      "twitter_card": "summary_large_image",
                      "twitter_site": "@example",
                      "sources": {
                        "title": "og",
                        "description": "og",
                        "image": "og"
                      }
                    },
                    "image": {
                      "url": "https://cdn.example.net/images/card.png",
                      "status": 200,
                      "info": {
                        "format": "png",
                        "width": 1200,
                        "height": 630,
                        "bytes": 3176,
                        "content_type": "image/png",
                        "type_matches": true,
                        "animated": false
                      },
                      "https": true,
                      "absolute": true,
                      "preview": "data:image/webp;base64,UklGRk4DAABXRUJQVlA4IEIDAACwQQCdASpYAjsBPm02mEkkIqKhIAmogA2JaW7hdoH+9gJvAkjyQQBLf/P/MSv8A6f831ir/gB6IBYKU4u7FkkkrxNAkKp8ksOTENbDkn9MU3W3zp8Y71WI9p81zm48RTd3bAoBjp1XZiHzElGT8c2H45r7EheMmleNSmVuTf+YkH5le5krd1vTqt05OqfjmvsV/cHB1s5qlmJGPfrjbjUMadYVdmIfMSUeC8Gm1PbhZeTJp1S3nb5GIq/5iQfmVyQsuNuNQxp2DIAg02p7cLLn62c1SzEjNWyINkrd1PU7sWVFT8c19iQvGTSvGpTK3Jv/MSD8yvcyVu63p1W6cnVPxzX2K/uDg62c1SzEjHv1xtxqGNOsKuzEPmJKPBeDTantwsvJk06pbzt8jEVf8xIPzK97Cbu7v1xtDv3yMQ+gEGmm8B2H45r7Ff3BwdbOapZiRj364241DGnWFXZiHzElHgvBptT24WXkyadUt52+RiKv+YkH5le9hN3d3642h375GIfQCDTTeA7D8c19iv7g4OtnNUsxIx79cbcahjTrCrsxD5iSjwXg02p7cLLyZNOqW87fIxFX/MSD8yvewm7u79cbQ798jEPoBBppvAdh+Oa+xX9wcHWzmqWYkY9+uNuNQxp1hV2Yh8xJR4LwabU9uFl5MmnVLedvkYir/mJB+ZXvYTd3d+uNod++RiH0Ag003gOw9AAA/t4jGspmP//46v37yvf+z49//+hHez3HE1QQA3dgz/W36ve8itKCtCmm3jp91mNiNR6c71QB/3N3D+8px9WM/p+rqvZp7eCt7Dw8qkFyu8U6OblqUNLOntYv0hPvxb7Ev1t+r3yji98fPIGEi6+29pneqAMnAhFEkwrl9sOv1GjEGuDvV/TFKjCuTpBfFMJuJsttJAZe2kMI0R3EINIIDLbfXhECvdfzOwtUx2q5F3wZa+Uo24P8Lgq8yqfdG3IzhcDMrJQboPp98XdKNuRnC4GZrDUIFfkgnT40bcjOFwMzWGoQK/JBOnxo25GcLgZmsNQgV+SCdPjRtyM4XAzNYahAr8kE6fGjbkZwuBmaw1CBX5IJ0+NG3IzhcDM1hqECvyQTp8aNuRnAgAA=",
                      "ratio": 1.9
                    },
                    "platforms": [
                      "linkedin",
                      "x",
                      "facebook",
                      "slack",
                      "whatsapp"
                    ],
                    "refresh_tools": {
                      "linkedin": "https://www.linkedin.com/post-inspector/",
                      "facebook": "https://developers.facebook.com/tools/debug/"
                    }
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "social-preview",
        "x-dnssuper-price": "Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "check_social_preview",
          "example": "Links to example.com show a full preview: a title, a description and a 1200 x 630 image.\nTitle (og): Example Widgets\nDescription (og): Widgets for every workshop, shipped worldwide.\nImage (og): https://cdn.example.net/images/card.png, 1200 x 630 png\nPreview copy: 600x315 WebP\nX card: summary_large_image\nShows an image on: LinkedIn, X, Facebook, Slack, WhatsApp\nRefresh: linkedin https://www.linkedin.com/post-inspector/; facebook https://developers.facebook.com/tools/debug/\nNo issues found.\nCredits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/metadata": {
      "get": {
        "tags": [
          "Website"
        ],
        "summary": "Site metadata and logo",
        "description": "A site's title, description, language, social profiles, icons and logo. Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 15 minutes; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_website_logo",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "A domain or URL; only the site (scheme and host) is used.",
              "examples": [
                "example.com"
              ],
              "x-widget": "url",
              "x-mono": true,
              "title": "Url"
            },
            "description": "A domain or URL; only the site (scheme and host) is used."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/WebsiteLogoResponse"
                },
                "example": {
                  "tool": "website-logo",
                  "target": "https://example.com/",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 1,
                  "summary": "example.com has a title, a description and 6 working icons. The logo comes from its structured data.",
                  "findings": [],
                  "data": {
                    "url": "https://example.com/",
                    "final_url": "https://example.com/",
                    "title": "Example Widgets",
                    "description": "Widgets for every workshop.",
                    "canonical": "https://example.com/",
                    "lang": "en",
                    "site_name": "Example",
                    "social_profiles": [
                      {
                        "network": "linkedin",
                        "url": "https://www.linkedin.com/company/example"
                      },
                      {
                        "network": "github",
                        "url": "https://github.com/example"
                      },
                      {
                        "network": "x",
                        "url": "https://x.com/example"
                      },
                      {
                        "network": "youtube",
                        "url": "https://www.youtube.com/@example"
                      },
                      {
                        "network": "mastodon",
                        "url": "https://social.example.net/@example"
                      }
                    ],
                    "icons": [
                      {
                        "url": "https://cdn.example.net/brand/logo.png",
                        "source": "jsonld",
                        "info": {
                          "format": "png",
                          "width": 512,
                          "height": 512,
                          "bytes": 1512,
                          "content_type": "image/png",
                          "type_matches": true,
                          "animated": false
                        },
                        "status": 200,
                        "display": "data:image/webp;base64,UklGRpYAAABXRUJQVlA4IIoAAADwBwCdASpAAEAAPm02mEkkIyKhIggAgA2JaQDU9oAYroB6IBXT8uhI87xkk7LXCfidhRJ3fJO7UgJi8BTpO3ZWPDtkGIBUjegA/vwTUuRd1KX//G8eBXkuyv//FtI6FTlGbaJw+rT21LXD6ufBfoLnyiEKXL5JHcWzTUwj29wQFOT2Gy55CTlgAAA="
                      },
                      {
                        "url": "https://example.com/apple-touch-icon.png",
                        "source": "apple-touch-icon",
                        "declared_sizes": "180x180",
                        "info": {
                          "format": "png",
                          "width": 180,
                          "height": 180,
                          "bytes": 400,
                          "content_type": "image/png",
                          "type_matches": true,
                          "animated": false
                        },
                        "status": 200,
                        "display": "data:image/webp;base64,UklGRtYAAABXRUJQVlA4IMoAAAAQCACdASpAAEAAPm0sk0ckIiGhqBQN+IANiWcA0bHu+AL//z/wP/SrPzCC/7Saq/4GWg33W4RtgSuVgF7tOU0CJ8hNPOemipyAAP7zYCWTPiCb/oBjlzJ//iLA/St+UKb1n/i3xB62uWAZQ+57uqV/39vuJVtwBTWwOxUrKQf5+Vsmnowbjfsw4INvv5DXBdV+K2dPsOUGJpC2cy+LcixtfRlBvohF4l+caxXrV7WzBeRtkkE8nfeFGtMhABWaCO7qrQlTTnK5CgAA"
                      },
                      {
                        "url": "https://example.com/favicon.svg",
                        "source": "icon",
                        "info": {
                          "format": "svg",
                          "width": 64,
                          "height": 64,
                          "bytes": 201,
                          "content_type": "image/svg+xml",
                          "type_matches": true,
                          "animated": false
                        },
                        "status": 200,
                        "display": "data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSI2NCIgaGVpZ2h0PSI2NCIgdmlld0JveD0iMCAwIDY0IDY0Ij48dGl0bGU+RXhhbXBsZTwvdGl0bGU+PHJlY3Qgd2lkdGg9IjY0IiBoZWlnaHQ9IjY0IiBmaWxsPSIjMWU1YWEwIiAvPjxjaXJjbGUgY3g9IjMyIiBjeT0iMzIiIHI9IjIwIiBmaWxsPSIjZmZmIiAvPjwvc3ZnPg=="
                      },
                      {
                        "url": "https://example.com/favicon-32.png",
                        "source": "icon",
                        "declared_sizes": "32x32",
                        "info": {
                          "format": "png",
                          "width": 32,
                          "height": 32,
                          "bytes": 114,
                          "content_type": "image/png",
                          "type_matches": true,
                          "animated": false
                        },
                        "status": 200,
                        "display": "data:image/webp;base64,UklGRqoAAABXRUJQVlA4IJ4AAADwBwCdASogACAAPm0ylEgkIqIhKAgAgA2JQBdl9i9ApgOAB//8T/3QD+zb//1f7tAfgBHgP4B+QF2A/gH3Ab3+EmYmn46+wCgA/adpy3kB1GNCAC6k12ERw/656MAUYApjs39HIAOC1Vr0ydAzXpU2i0zS6d58vFWRKLX+kK6vrekoBBf0inU6v3YxytXk9XPI7MfoCEEABWYPBJAAAA=="
                      },
                      {
                        "url": "https://example.com/icon-512.png",
                        "source": "manifest",
                        "declared_sizes": "512x512",
                        "info": {
                          "format": "png",
                          "width": 512,
                          "height": 512,
                          "bytes": 1512,
                          "content_type": "image/png",
                          "type_matches": true,
                          "animated": false
                        },
                        "status": 200,
                        "display": "data:image/webp;base64,UklGRowAAABXRUJQVlA4IIAAAADwBgCdASpAAEAAPm02mEkkIqKkIggAgA2JZwDU9oB+AA8gACnHhcCRU7ypKneVJU7zfuONzwoxPg7PB8bOc7NgAP7sfoH/V120//8lNf425av/33oDeL/CcUj2u5+QhEJZOteXaVLxyq8VzQ0HGMxX+48h36myNr0sVpQcpVlIAA=="
                      },
                      {
                        "url": "https://example.com/favicon.ico",
                        "source": "favicon.ico",
                        "info": {
                          "format": "ico",
                          "width": 48,
                          "height": 48,
                          "bytes": 421,
                          "content_type": "image/x-icon",
                          "type_matches": true,
                          "animated": false
                        },
                        "status": 200,
                        "display": "data:image/webp;base64,UklGRkYAAABXRUJQVlA4IDoAAAAwAwCdASowADAAPm02mEkkIyKhI4gAgA2JZwAAHdTYOy0AAP7wOEP3uWikV//8wT/3+/7/eS4AAAAA"
                      }
                    ],
                    "logo": {
                      "url": "https://cdn.example.net/brand/logo.png",
                      "source": "jsonld",
                      "format": "png",
                      "width": 512,
                      "height": 512,
                      "fallback": false,
                      "png_256": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAQAAAAEACAIAAADTED8xAAACKklEQVR42u3Tuw1AYACFUa/8UWh1ClvYwFDGkCjMoFFbQgzkUWiVColzBrjFTb64G5Z+WvOQRm/bj7Mqi7apx3nLQ2bf/qf2b0kEPyYABAACAAGAAEAAIAAQAAgABAACAAGAAEAAIAAQAAgABAACAAGAAEAAIAAQAAgABAACAAGAAEAAIAAQAAgABAACAAGAAEAAIAAQAAgABAACAAGAAEAAIAAQAAgABAACAAEgABAACAAEAAIAAYAAQAAgABAACAAEAAIAAYAAQAAgABAACAAEAAIAAYAAQAAgABAACAAEAAIAAYAAQAAgABAACAAEAAIAAYAAQAAgABAACAAEAAIAAYAAQAAgABAACAAEgABAACAAEAAIAAQAAgABgABAACAAEAAIAAQAAgABgABAACAAEAAIAAQAAgABgABAACAAEAAIAAQAAgABgABAACAAEAAIAAQAAgABgABAACAAEAAIAAQAAgABgABAACAABOACBAACAAGAAEAAIAAQAAgABAACAAGAAEAAIAAQAAgABAACAAGAAEAAIAAQAAgABAACAAGAAEAAIAAQAAgABAACAAGAAEAAIAAQAAgABAACAAGAAEAAIAAQAAgABAACAAEgABAACAAEAAIAAYAAQAAgABAACAAEAAIAAYAAQAAgABAACAAEAAIAAYAAQAAgABAACAAEAAIAAYAAQAAgABAACAAEAAIAAYAAQAAgABAACAAEAAIAAYAA4MkFFUQv5qzPL3gAAAAASUVORK5CYII=",
                      "png_128": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAIAAAACACAIAAABMXPacAAAA7ElEQVR42u3RuwmAUBREQX9gIIK5qb1YjVVZjfBisQPt4hq8AhTEbE680U45L+u2n01dFU9FRN+10zik47L/vs+93emnAAAAIAAABACAAAAQAAACAEAAAAgAAAEAIAAABACAAAAQAAACAEAAAAgAAAEAIAAABACAAAAQAAACAEAAAAgAAAEAIAAABACAAAAQAAACAEAAAAgAAAAuAABAAAAIAAABACAAAAQAgAAAEAAAAgBAAAAIAAABACAAAAQAgAAAEAAAAgBAAAAIAAABACAAAAQAgAAAEAAAAgBAAAAIAAABACAAAAQAgHI34iUu5hZH/78AAAAASUVORK5CYII=",
                      "svg_removed": []
                    },
                    "manifest": {
                      "name": "Example Widgets",
                      "short_name": "Example",
                      "theme_color": "#1e5aa0",
                      "background_color": "#ffffff",
                      "icons": [
                        {
                          "src": "https://example.com/icon-192.png",
                          "sizes": "192x192",
                          "type": "image/png"
                        },
                        {
                          "src": "https://example.com/icon-512.png",
                          "sizes": "512x512",
                          "type": "image/png"
                        }
                      ]
                    }
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "website-logo",
        "x-dnssuper-price": "Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for up to 15 minutes; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "get_site_metadata",
          "example": "example.com has a title, a description and 6 working icons. The logo comes from its structured data.\nTitle: Example Widgets\nDescription: Widgets for every workshop.\nLanguage: en | Site name: Example\nSocial: linkedin, github, x, youtube, mastodon\nIcons: 6 checked, 6 working\nLogo: from structured data, png 512 x 512\nLogo copy: 256x256 PNG\nNo issues found.\nCredits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/tech": {
      "get": {
        "tags": [
          "Website"
        ],
        "summary": "Tech stack detection",
        "description": "Technologies a site uses, detected from headers, cookies, HTML and DNS, with the evidence. Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 15 minutes; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_tech_stack_checker",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "A domain or URL; only the site (scheme and host) is used.",
              "examples": [
                "example.com"
              ],
              "x-widget": "url",
              "x-mono": true,
              "title": "Url"
            },
            "description": "A domain or URL; only the site (scheme and host) is used."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/TechStackCheckerResponse"
                },
                "example": {
                  "tool": "tech-stack-checker",
                  "target": "https://example.com/",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 2,
                  "summary": "We found 11 technologies on example.com, including WordPress, Cloudflare and jQuery.",
                  "findings": [
                    {
                      "id": "tech.version_exposed",
                      "severity": "info",
                      "title": "Software versions are visible",
                      "detail": "Visible: WordPress 6.4.2, PHP 8.2.14.",
                      "fix": "Hide version numbers from headers and generator tags."
                    }
                  ],
                  "data": {
                    "url": "https://example.com/",
                    "final_url": "https://example.com/",
                    "technologies": [
                      {
                        "id": "wordpress",
                        "name": "WordPress",
                        "category": "cms",
                        "category_label": "CMS",
                        "version": "6.4.2",
                        "confidence": 100,
                        "evidence": [
                          {
                            "kind": "meta",
                            "detail": "meta generator"
                          },
                          {
                            "kind": "html",
                            "detail": "page contains /wp-content/"
                          },
                          {
                            "kind": "header",
                            "detail": "header link"
                          },
                          {
                            "kind": "cookie",
                            "detail": "cookie wp-settings-*"
                          },
                          {
                            "kind": "script_src",
                            "detail": "script URL"
                          }
                        ],
                        "website": "https://wordpress.org"
                      },
                      {
                        "id": "as64496",
                        "name": "Example Network Ltd",
                        "category": "hosting",
                        "category_label": "Hosting",
                        "confidence": 70,
                        "evidence": [
                          {
                            "kind": "asn",
                            "detail": "Network AS64496"
                          }
                        ]
                      },
                      {
                        "id": "cloudflare",
                        "name": "Cloudflare",
                        "category": "cdn",
                        "category_label": "CDN",
                        "confidence": 100,
                        "evidence": [
                          {
                            "kind": "header",
                            "detail": "header server"
                          },
                          {
                            "kind": "header",
                            "detail": "header cf-ray"
                          },
                          {
                            "kind": "cookie",
                            "detail": "cookie __cf_bm"
                          }
                        ],
                        "website": "https://www.cloudflare.com"
                      },
                      {
                        "id": "dns-cloudflare",
                        "name": "Cloudflare DNS",
                        "category": "dns",
                        "category_label": "DNS host",
                        "confidence": 90,
                        "evidence": [
                          {
                            "kind": "ns",
                            "detail": "NS records"
                          }
                        ]
                      },
                      {
                        "id": "mail-google-workspace",
                        "name": "Google Workspace",
                        "category": "email",
                        "category_label": "Email provider",
                        "confidence": 90,
                        "evidence": [
                          {
                            "kind": "mx",
                            "detail": "MX records"
                          }
                        ]
                      },
                      {
                        "id": "php",
                        "name": "PHP",
                        "category": "language",
                        "category_label": "Programming language",
                        "version": "8.2.14",
                        "confidence": 100,
                        "evidence": [
                          {
                            "kind": "header",
                            "detail": "header x-powered-by"
                          },
                          {
                            "kind": "implied",
                            "detail": "implied by WordPress"
                          }
                        ],
                        "website": "https://www.php.net"
                      },
                      {
                        "id": "jquery",
                        "name": "jQuery",
                        "category": "js-library",
                        "category_label": "JavaScript library",
                        "confidence": 90,
                        "evidence": [
                          {
                            "kind": "script_src",
                            "detail": "script URL"
                          }
                        ],
                        "website": "https://jquery.com"
                      },
                      {
                        "id": "google-analytics",
                        "name": "Google Analytics",
                        "category": "analytics",
                        "category_label": "Analytics",
                        "confidence": 100,
                        "evidence": [
                          {
                            "kind": "script_src",
                            "detail": "script URL"
                          }
                        ],
                        "website": "https://marketingplatform.google.com/about/analytics/"
                      },
                      {
                        "id": "google-fonts",
                        "name": "Google Fonts",
                        "category": "fonts",
                        "category_label": "Font service",
                        "confidence": 100,
                        "evidence": [
                          {
                            "kind": "link_href",
                            "detail": "stylesheet or link URL"
                          }
                        ],
                        "website": "https://fonts.google.com"
                      },
                      {
                        "id": "google-workspace",
                        "name": "Google site verification",
                        "category": "saas",
                        "category_label": "SaaS tool (from DNS verification)",
                        "confidence": 100,
                        "evidence": [
                          {
                            "kind": "txt",
                            "detail": "TXT google-site-verification"
                          }
                        ],
                        "website": "https://support.google.com/webmasters/answer/9008080"
                      },
                      {
                        "id": "facebook-domain",
                        "name": "Meta domain verification",
                        "category": "saas",
                        "category_label": "SaaS tool (from DNS verification)",
                        "confidence": 100,
                        "evidence": [
                          {
                            "kind": "txt",
                            "detail": "TXT facebook-domain-verification"
                          }
                        ],
                        "website": "https://developers.facebook.com/docs/sharing/domain-verification"
                      }
                    ],
                    "by_category": {
                      "cms": [
                        "wordpress"
                      ],
                      "hosting": [
                        "as64496"
                      ],
                      "cdn": [
                        "cloudflare"
                      ],
                      "dns": [
                        "dns-cloudflare"
                      ],
                      "email": [
                        "mail-google-workspace"
                      ],
                      "language": [
                        "php"
                      ],
                      "js-library": [
                        "jquery"
                      ],
                      "analytics": [
                        "google-analytics"
                      ],
                      "fonts": [
                        "google-fonts"
                      ],
                      "saas": [
                        "google-workspace",
                        "facebook-domain"
                      ]
                    },
                    "catalog_size": 194,
                    "dns_checked": true,
                    "network": {
                      "asn": 64496,
                      "name": "EXAMPLE-NET",
                      "country": "NL"
                    }
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "tech-stack-checker",
        "x-dnssuper-price": "Costs 2 credits per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for up to 15 minutes; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "detect_tech_stack",
          "example": "We found 11 technologies on example.com, including WordPress, Cloudflare and jQuery.\nCMS: WordPress 6.4.2\nHosting: Example Network Ltd (70%)\nCDN: Cloudflare\nDNS host: Cloudflare DNS (90%)\nEmail provider: Google Workspace (90%)\nProgramming language: PHP 8.2.14\nJavaScript library: jQuery (90%)\n+4 more lines (pass detail='full' to see all)\n- info: Software versions are visible\nCredits: 2 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/redirects": {
      "get": {
        "tags": [
          "Website"
        ],
        "summary": "Redirect tracer",
        "description": "Every hop of a URL's redirect chain, including meta refresh and literal JavaScript redirects, without running scripts. Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_redirect_checker",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "url",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "A URL or short link; we follow it without running any script.",
              "examples": [
                "example.com"
              ],
              "x-widget": "url",
              "x-mono": true,
              "x-placeholder": "https://bit.ly/...",
              "title": "Url"
            },
            "description": "A URL or short link; we follow it without running any script."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/RedirectCheckerResponse"
                },
                "example": {
                  "tool": "redirect-checker",
                  "target": "http://example.com/promo",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 1,
                  "summary": "2 redirects to www.example.com, which answers 200.",
                  "findings": [
                    {
                      "id": "redirect.tracking_params",
                      "severity": "info",
                      "title": "The final address carries tracking parameters",
                      "detail": "utm_source, gclid.",
                      "fix": "Use the clean URL shown if you share the link."
                    }
                  ],
                  "data": {
                    "start_url": "http://example.com/promo",
                    "final_url": "https://www.example.com/sale?utm_source=newsletter&gclid=abc123&id=7",
                    "final_status": 200,
                    "hops": [
                      {
                        "url": "http://example.com/promo",
                        "status": 301,
                        "location": "https://example.com/promo",
                        "elapsed_ms": 12,
                        "cookie_names": [],
                        "kind": "http",
                        "address": "192.0.2.10",
                        "same_site_as_start": true
                      },
                      {
                        "url": "https://example.com/promo",
                        "status": 301,
                        "location": "https://www.example.com/sale?utm_source=newsletter&gclid=abc123&id=7",
                        "elapsed_ms": 12,
                        "cookie_names": [
                          "visit"
                        ],
                        "kind": "http",
                        "address": "192.0.2.10",
                        "same_site_as_start": true
                      },
                      {
                        "url": "https://www.example.com/sale?utm_source=newsletter&gclid=abc123&id=7",
                        "status": 200,
                        "elapsed_ms": 12,
                        "cookie_names": [],
                        "kind": "http",
                        "address": "192.0.2.10",
                        "same_site_as_start": true
                      }
                    ],
                    "stop": "final",
                    "total_ms": 12,
                    "cross_domain": false,
                    "shorteners": [],
                    "clean_final_url": "https://www.example.com/sale?id=7",
                    "removed_params": [
                      "utm_source",
                      "gclid"
                    ]
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "redirect-checker",
        "x-dnssuper-price": "Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "trace_redirects",
          "example": "2 redirects to www.example.com, which answers 200.\n1. 301 http://example.com/promo\n2. 301 https://example.com/promo (sets cookie: visit)\n3. 200 https://www.example.com/sale?utm_source=newsletter&gclid=abc123&id=7\nWithout tracking parameters: https://www.example.com/sale?id=7\n- info: The final address carries tracking parameters\nCredits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/broken-links": {
      "post": {
        "tags": [
          "Website"
        ],
        "summary": "Broken link checker",
        "description": "Broken, redirected and unverifiable links found by crawling a site, with the pages that link to them. Costs 5 credits per 50 pages (rounded up). The maximum is reserved when the job starts, and you pay only for the pages crawled. Failed runs are free. Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again.",
        "operationId": "run_broken_link_checker",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/BrokenLinkCheckerParams"
              },
              "example": {
                "url": "example.com",
                "max_pages": 50,
                "external": true
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobStartResponse"
                },
                "example": {
                  "job_id": "7a5dfd02-262a-51e2-a6f7-5edef555df9c",
                  "status": "queued",
                  "total": 1,
                  "credits_reserved": 5,
                  "duplicates_removed": 0,
                  "job_url": "https://api.dnssuper.localhost/v1/jobs/7a5dfd02-262a-51e2-a6f7-5edef555df9c",
                  "items_url": "https://api.dnssuper.localhost/v1/jobs/7a5dfd02-262a-51e2-a6f7-5edef555df9c/items",
                  "events_url": "https://api.dnssuper.localhost/v1/jobs/7a5dfd02-262a-51e2-a6f7-5edef555df9c/events"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ],
        "x-dnssuper-tool": "broken-link-checker",
        "x-dnssuper-price": "Costs 5 credits per 50 pages (rounded up). The maximum is reserved when the job starts, and you pay only for the pages crawled. Failed runs are free.",
        "x-dnssuper-cache": "Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "check_broken_links",
          "example": "5 broken links found on example.com (14 pages crawled, 28 links checked).\nCrawled 14 pages (completed)\nBroken: 5 (2 on the site, 1 resource, 2 to other sites); unverified 5; timed out 1\n404 https://example.com/missing <- https://example.com/ (\"Spring sale\")\n500 https://example.com/error <- https://example.com/blog/1 (\"Comments\")\n404 https://example.com/img/gone.png <- https://example.com/ (\"Banner\")\nnxdomain https://gone.example.org/ <- https://example.com/blog/2 (\"A closed shop\")\n404 https://www.example.org/gone <- https://example.com/ (\"Old partner page\")\n- fail: Links to your own pages are broken. Fix: Fix or remove the links listed.\n- fail: Images, scripts or styles don't load. Fix: Fix the file paths or restore the files.\n- warn: Links to other sites are broken. Fix: Update or remove the links listed.\n- warn: Some links didn't answer in time. Fix: Check them by hand; the sites may be slow.\n+4 more findings (pass detail='full' to see all)\nCredits: 5 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/cookies": {
      "post": {
        "tags": [
          "Website"
        ],
        "summary": "Cookie and tracker scan",
        "description": "Cookies, storage, third parties and trackers seen on one visit before any consent, and the consent banner. Costs 5 credits, reserved when the job starts and charged when it finishes. Failed runs are free. Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again.",
        "operationId": "run_cookie_scanner",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CookieScannerParams"
              },
              "example": {
                "url": "https://www.example.com/"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobStartResponse"
                },
                "example": {
                  "job_id": "9dfc7215-93b7-54e5-a30d-04a95397f350",
                  "status": "queued",
                  "total": 1,
                  "credits_reserved": 5,
                  "duplicates_removed": 0,
                  "job_url": "https://api.dnssuper.localhost/v1/jobs/9dfc7215-93b7-54e5-a30d-04a95397f350",
                  "items_url": "https://api.dnssuper.localhost/v1/jobs/9dfc7215-93b7-54e5-a30d-04a95397f350/items",
                  "events_url": "https://api.dnssuper.localhost/v1/jobs/9dfc7215-93b7-54e5-a30d-04a95397f350/events"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ],
        "x-dnssuper-tool": "cookie-scanner",
        "x-dnssuper-price": "Costs 5 credits, reserved when the job starts and charged when it finishes. Failed runs are free.",
        "x-dnssuper-cache": "Answers are cached for up to 15 minutes, per account except for a site's home page; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "scan_cookies",
          "example": "3 trackers loaded before any consent on www.example.com. These are technical observations from one visit from an EU server, not legal advice.\nConsent: OneTrust banner showing (TCF)\nTrackers before consent: Meta Pixel (advertising), Google Tag Manager (tag_manager), Google Analytics (analytics)\nCookies: 7 (6 first party, 1 third party); storage keys: 2\nOther sites contacted: 6 (2 not in our catalog)\nCNAME cloaking: metrics.example.com -> Adobe Analytics\nscreenshot: 800x49 WebP\n- fail: Trackers load before consent. Fix: Load tracking scripts only after a visitor agrees.\n- fail: Tracking cookies are set before consent. Fix: Set tracking cookies only after a visitor agrees.\n- warn: A tracker hides behind your own domain. Fix: Review the subdomain that points to a tracking service.\n- warn: Some cookies lack Secure. Fix: Add Secure to every cookie on an HTTPS site.\n+5 more findings (pass detail='full' to see all)\nCredits: 5 credits used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/ssl": {
      "get": {
        "tags": [
          "Certificates and network"
        ],
        "summary": "SSL check",
        "description": "The certificate on port 443 for the domain and www: chain and trust, expiry, names covered, key and signature, TLS versions offered, and a grade. Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 1 hour; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_ssl_checker",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 2048,
              "description": "A domain or URL; port 443 is always checked.",
              "examples": [
                "example.com"
              ],
              "title": "Domain"
            },
            "description": "A domain or URL; port 443 is always checked."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SslCheckerResponse"
                },
                "example": {
                  "tool": "ssl-checker",
                  "target": "example.com",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 1,
                  "summary": "example.com's certificate on port 443 is trusted and valid for 62 more days, covering example.com and www.example.com. The server offers TLS 1.3.",
                  "score": 100,
                  "findings": [],
                  "data": {
                    "name": "example.com",
                    "unicode": "example.com",
                    "hosts": [
                      {
                        "host": "example.com",
                        "status": "ok",
                        "address": "192.0.2.10",
                        "tls": {
                          "version": "TLSv1.3",
                          "cipher": "TLS_AES_128_GCM_SHA256",
                          "forward_secrecy": true,
                          "alpn": "h2",
                          "versions": {
                            "TLSv1.3": true,
                            "TLSv1.2": true,
                            "TLSv1.1": false,
                            "TLSv1.0": false
                          },
                          "non_forward_secret": false,
                          "ocsp_stapled": false
                        },
                        "certificate": {
                          "subject": "CN=example.com",
                          "common_name": "example.com",
                          "names": [
                            "example.com",
                            "www.example.com"
                          ],
                          "issuer": "CN=Example Issuing CA 1,O=Example Trust Services",
                          "issuer_org": "Example Trust Services",
                          "caa_identifiers": [],
                          "serial": "DD50001",
                          "not_before": "2026-10-15T10:00:00Z",
                          "not_after": "2027-01-15T10:00:00Z",
                          "days_left": 62,
                          "key": {
                            "type": "EC",
                            "size": 256,
                            "curve": "secp256r1"
                          },
                          "signature_algorithm": "ecdsa-with-SHA256",
                          "sha256": "743c1c3c7fac8a213ec88acd9fbb53f54072675448f8b099de2458cbcafaff65",
                          "scts": 2,
                          "ca_issuers_url": "http://ca.example-ca.net/intermediate.der"
                        },
                        "chain": [
                          {
                            "subject": "CN=example.com",
                            "issuer": "CN=Example Issuing CA 1,O=Example Trust Services",
                            "not_after": "2027-01-15T10:00:00Z",
                            "sha256": "743c1c3c7fac8a213ec88acd9fbb53f54072675448f8b099de2458cbcafaff65",
                            "is_ca": false,
                            "self_signed": false,
                            "pem": "-----BEGIN CERTIFICATE-----\nMIICmTCCAj+gAwIBAgIEDdUAATAKBggqhkjOPQQDAjBAMR8wHQYDVQQKDBZFeGFt\ncGxlIFRydXN0IFNlcnZpY2VzMR0wGwYDVQQDDBRFeGFtcGxlIElzc3VpbmcgQ0Eg\nMTAeFw0yNjEwMTUxMDAwMDBaFw0yNzAxMTUxMDAwMDBaMBYxFDASBgNVBAMMC2V4\nYW1wbGUuY29tMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEfO7WksKIHG6uJqa3\n6So0HYq6vCa1u/fh/upQC/6LzF39dygCaZgg5EQ8LLZV2VvndDC+BEmXqIqzlcPG\nHjIIXqOCAU8wggFLMAwGA1UdEwEB/wQCMAAwDgYDVR0PAQH/BAQDAgeAMBMGA1Ud\nJQQMMAoGCCsGAQUFBwMBMB8GA1UdIwQYMBaAFNJrTleFVnmjKhl/60LXow/xyzy1\nMCcGA1UdEQQgMB6CC2V4YW1wbGUuY29tgg93d3cuZXhhbXBsZS5jb20wRQYIKwYB\nBQUHAQEEOTA3MDUGCCsGAQUFBzAChilodHRwOi8vY2EuZXhhbXBsZS1jYS5uZXQv\naW50ZXJtZWRpYXRlLmRlcjCBhAYKKwYBBAHWeQIEAgR2BHQAcgA3AAEBAQEBAQEB\nAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAAABodRZiQAAAAQDAAgwBgIBAQIBAQA3\nAAICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAAABodRZiQAAAAQDAAgw\nBgIBAQIBATAKBggqhkjOPQQDAgNIADBFAiEA3rxYH6BqT4aQJRMD+1rOdZIuBuo7\nAs6nwvtcVRvZ/xoCIFDCxiuv8a15Xg8ZsfrJ4Rk0vLjwqD6/zIduVr2n28F0\n-----END CERTIFICATE-----\n"
                          },
                          {
                            "subject": "CN=Example Issuing CA 1,O=Example Trust Services",
                            "issuer": "CN=Example Root R1,O=Example Trust Services",
                            "not_after": "2029-11-13T10:00:00Z",
                            "sha256": "3047b601d496c641600c9a9f5ba3681402c8fa77978696b93808d4e2a432c649",
                            "is_ca": true,
                            "self_signed": false,
                            "pem": "-----BEGIN CERTIFICATE-----\nMIIBzzCCAXSgAwIBAgICcaEwCgYIKoZIzj0EAwIwOzEfMB0GA1UECgwWRXhhbXBs\nZSBUcnVzdCBTZXJ2aWNlczEYMBYGA1UEAwwPRXhhbXBsZSBSb290IFIxMB4XDTI1\nMTExNDEwMDAwMFoXDTI5MTExMzEwMDAwMFowQDEfMB0GA1UECgwWRXhhbXBsZSBU\ncnVzdCBTZXJ2aWNlczEdMBsGA1UEAwwURXhhbXBsZSBJc3N1aW5nIENBIDEwWTAT\nBgcqhkjOPQIBBggqhkjOPQMBBwNCAATZ5oN9WLrjjXlTCS166j1AFHd7X0xShWSj\nnIFOd0loaR2DeXT/T4o1/f+EpMVtdZgLnbPrWRrFadp9VxmLgv/Vo2MwYTAPBgNV\nHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQU0mtOV4VWeaMq\nGX/rQtejD/HLPLUwHwYDVR0jBBgwFoAUXzm0FsPAx8gBuBni0NVHsgUxjIowCgYI\nKoZIzj0EAwIDSQAwRgIhAMYiF0BFFTpgucp4JnrqGd/XURVGelUa34UbxM0uam7I\nAiEAtRCg/a3hsQYaaZ5yVVftVWSmCxvjEjCblqj7vDrfi2Q=\n-----END CERTIFICATE-----\n"
                          }
                        ],
                        "trust": {
                          "trusted": true,
                          "hostname_match": true,
                          "root": "CN=Example Root R1,O=Example Trust Services",
                          "path": [
                            "CN=example.com",
                            "CN=Example Issuing CA 1,O=Example Trust Services",
                            "CN=Example Root R1,O=Example Trust Services"
                          ]
                        }
                      },
                      {
                        "host": "www.example.com",
                        "status": "ok",
                        "address": "192.0.2.11",
                        "tls": {
                          "version": "TLSv1.3",
                          "cipher": "TLS_AES_128_GCM_SHA256",
                          "forward_secrecy": true,
                          "alpn": "h2",
                          "versions": {
                            "TLSv1.3": true,
                            "TLSv1.2": true,
                            "TLSv1.1": false,
                            "TLSv1.0": false
                          },
                          "non_forward_secret": false,
                          "ocsp_stapled": false
                        },
                        "certificate": {
                          "subject": "CN=example.com",
                          "common_name": "example.com",
                          "names": [
                            "example.com",
                            "www.example.com"
                          ],
                          "issuer": "CN=Example Issuing CA 1,O=Example Trust Services",
                          "issuer_org": "Example Trust Services",
                          "caa_identifiers": [],
                          "serial": "DD50001",
                          "not_before": "2026-10-15T10:00:00Z",
                          "not_after": "2027-01-15T10:00:00Z",
                          "days_left": 62,
                          "key": {
                            "type": "EC",
                            "size": 256,
                            "curve": "secp256r1"
                          },
                          "signature_algorithm": "ecdsa-with-SHA256",
                          "sha256": "743c1c3c7fac8a213ec88acd9fbb53f54072675448f8b099de2458cbcafaff65",
                          "scts": 2,
                          "ca_issuers_url": "http://ca.example-ca.net/intermediate.der"
                        },
                        "chain": [
                          {
                            "subject": "CN=example.com",
                            "issuer": "CN=Example Issuing CA 1,O=Example Trust Services",
                            "not_after": "2027-01-15T10:00:00Z",
                            "sha256": "743c1c3c7fac8a213ec88acd9fbb53f54072675448f8b099de2458cbcafaff65",
                            "is_ca": false,
                            "self_signed": false,
                            "pem": "-----BEGIN CERTIFICATE-----\nMIICmTCCAj+gAwIBAgIEDdUAATAKBggqhkjOPQQDAjBAMR8wHQYDVQQKDBZFeGFt\ncGxlIFRydXN0IFNlcnZpY2VzMR0wGwYDVQQDDBRFeGFtcGxlIElzc3VpbmcgQ0Eg\nMTAeFw0yNjEwMTUxMDAwMDBaFw0yNzAxMTUxMDAwMDBaMBYxFDASBgNVBAMMC2V4\nYW1wbGUuY29tMFkwEwYHKoZIzj0CAQYIKoZIzj0DAQcDQgAEfO7WksKIHG6uJqa3\n6So0HYq6vCa1u/fh/upQC/6LzF39dygCaZgg5EQ8LLZV2VvndDC+BEmXqIqzlcPG\nHjIIXqOCAU8wggFLMAwGA1UdEwEB/wQCMAAwDgYDVR0PAQH/BAQDAgeAMBMGA1Ud\nJQQMMAoGCCsGAQUFBwMBMB8GA1UdIwQYMBaAFNJrTleFVnmjKhl/60LXow/xyzy1\nMCcGA1UdEQQgMB6CC2V4YW1wbGUuY29tgg93d3cuZXhhbXBsZS5jb20wRQYIKwYB\nBQUHAQEEOTA3MDUGCCsGAQUFBzAChilodHRwOi8vY2EuZXhhbXBsZS1jYS5uZXQv\naW50ZXJtZWRpYXRlLmRlcjCBhAYKKwYBBAHWeQIEAgR2BHQAcgA3AAEBAQEBAQEB\nAQEBAQEBAQEBAQEBAQEBAQEBAQEBAQEBAAABodRZiQAAAAQDAAgwBgIBAQIBAQA3\nAAICAgICAgICAgICAgICAgICAgICAgICAgICAgICAgICAAABodRZiQAAAAQDAAgw\nBgIBAQIBATAKBggqhkjOPQQDAgNIADBFAiEA3rxYH6BqT4aQJRMD+1rOdZIuBuo7\nAs6nwvtcVRvZ/xoCIFDCxiuv8a15Xg8ZsfrJ4Rk0vLjwqD6/zIduVr2n28F0\n-----END CERTIFICATE-----\n"
                          },
                          {
                            "subject": "CN=Example Issuing CA 1,O=Example Trust Services",
                            "issuer": "CN=Example Root R1,O=Example Trust Services",
                            "not_after": "2029-11-13T10:00:00Z",
                            "sha256": "3047b601d496c641600c9a9f5ba3681402c8fa77978696b93808d4e2a432c649",
                            "is_ca": true,
                            "self_signed": false,
                            "pem": "-----BEGIN CERTIFICATE-----\nMIIBzzCCAXSgAwIBAgICcaEwCgYIKoZIzj0EAwIwOzEfMB0GA1UECgwWRXhhbXBs\nZSBUcnVzdCBTZXJ2aWNlczEYMBYGA1UEAwwPRXhhbXBsZSBSb290IFIxMB4XDTI1\nMTExNDEwMDAwMFoXDTI5MTExMzEwMDAwMFowQDEfMB0GA1UECgwWRXhhbXBsZSBU\ncnVzdCBTZXJ2aWNlczEdMBsGA1UEAwwURXhhbXBsZSBJc3N1aW5nIENBIDEwWTAT\nBgcqhkjOPQIBBggqhkjOPQMBBwNCAATZ5oN9WLrjjXlTCS166j1AFHd7X0xShWSj\nnIFOd0loaR2DeXT/T4o1/f+EpMVtdZgLnbPrWRrFadp9VxmLgv/Vo2MwYTAPBgNV\nHRMBAf8EBTADAQH/MA4GA1UdDwEB/wQEAwIBhjAdBgNVHQ4EFgQU0mtOV4VWeaMq\nGX/rQtejD/HLPLUwHwYDVR0jBBgwFoAUXzm0FsPAx8gBuBni0NVHsgUxjIowCgYI\nKoZIzj0EAwIDSQAwRgIhAMYiF0BFFTpgucp4JnrqGd/XURVGelUa34UbxM0uam7I\nAiEAtRCg/a3hsQYaaZ5yVVftVWSmCxvjEjCblqj7vDrfi2Q=\n-----END CERTIFICATE-----\n"
                          }
                        ],
                        "trust": {
                          "trusted": true,
                          "hostname_match": true,
                          "root": "CN=Example Root R1,O=Example Trust Services",
                          "path": [
                            "CN=example.com",
                            "CN=Example Issuing CA 1,O=Example Trust Services",
                            "CN=Example Root R1,O=Example Trust Services"
                          ]
                        }
                      }
                    ],
                    "trust_store": {
                      "source": "example root store",
                      "version": "test"
                    },
                    "legacy_versions_tested": true
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "x-dnssuper-tool": "ssl-checker",
        "x-dnssuper-price": "Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for up to 1 hour; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "check_ssl",
          "example": "example.com's certificate on port 443 is trusted and valid for 62 more days, covering example.com and www.example.com. The server offers TLS 1.3.\nScore: 100/100\nexample.com: trusted, issued by Example Trust Services, 62 days left, TLSv1.3\nwww.example.com: trusted, issued by Example Trust Services, 62 days left, TLSv1.3\nChecked port 443 against the example root store; TLS 1.0 and 1.1 tested\nNo issues found.\nCredits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/decode": {
      "post": {
        "tags": [
          "Certificates and network"
        ],
        "summary": "Certificate and CSR decoder",
        "description": "The decoded fields of pasted certificates and CSRs, and how a bundle chains; nothing is stored. Free; any API key works and nothing is charged. What you paste is processed in memory and never stored. Never cached; every call runs again.",
        "operationId": "run_certificate_decoder",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CertificateDecoderParams"
              },
              "example": {
                "pem": "-----BEGIN CERTIFICATE-----\nMIICvTCCAmSgAwIBAgIDCU7aMAoGCCqGSM49BAMCMF4xCzAJBgNVBAYTAlVTMRow\nGAYDVQQKDBFETlMgU3VwZXIgVGVzdCBDQTEzMDEGA1UEAwwqRE5TIFN1cGVyIFRl\nc3QgSW50ZXJtZWRpYXRlIENBICh0ZXN0IG9ubHkpMB4XDTI2MTAxNTEwMDAwMFoX\nDTI3MDExMzEwMDAwMFowJzELMAkGA1UEBhMCVVMxGDAWBgNVBAMMD3d3dy5leGFt\ncGxlLmNvbTBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABOuNR6jOY5/Esi7HskMr\ndTfqATnEINyKagaZvpGPCx3MPUbeByKqssTi9M458wOd1Em/xgM08GKzRxUYT2Ph\nJWejggFGMIIBQjAMBgNVHRMBAf8EAjAAMA4GA1UdDwEB/wQEAwIHgDATBgNVHSUE\nDDAKBggrBgEFBQcDATAdBgNVHQ4EFgQUz+mHNryuvRSV8z9B0YLAFRBF6e8wJwYD\nVR0RBCAwHoIPd3d3LmV4YW1wbGUuY29tggtleGFtcGxlLmNvbTAfBgNVHSMEGDAW\ngBRtNX5JQhk2je0jP2uYcU2JKK3acjBeBggrBgEFBQcBAQRSMFAwIwYIKwYBBQUH\nMAGGF2h0dHA6Ly9vY3NwLmV4YW1wbGUubmV0MCkGCCsGAQUFBzAChh1odHRwOi8v\nY2EuZXhhbXBsZS5uZXQvaW50LmRlcjAvBgNVHR8EKDAmMCSgIqAghh5odHRwOi8v\nY3JsLmV4YW1wbGUubmV0L2ludC5jcmwwEwYDVR0gBAwwCjAIBgZngQwBAgEwCgYI\nKoZIzj0EAwIDRwAwRAIgBBOdOCH809KoJDSW7yXQEXEoE9y7iRiGW2UrpcTaRUYC\nIDp/QYtQ1zNp2FaApO2EFKZ5phGmI0xj7m/Jxz6gguN3\n-----END CERTIFICATE-----\n-----BEGIN CERTIFICATE-----\nMIICDTCCAbKgAwIBAgIEYQAAAjAKBggqhkjOPQQDAjBWMQswCQYDVQQGEwJVUzEa\nMBgGA1UECgwRRE5TIFN1cGVyIFRlc3QgQ0ExKzApBgNVBAMMIkROUyBTdXBlciBU\nZXN0IFJvb3QgQ0EgKHRlc3Qgb25seSkwHhcNMjUwMTAxMDAwMDAwWhcNMzUwMTAx\nMDAwMDAwWjBeMQswCQYDVQQGEwJVUzEaMBgGA1UECgwRRE5TIFN1cGVyIFRlc3Qg\nQ0ExMzAxBgNVBAMMKkROUyBTdXBlciBUZXN0IEludGVybWVkaWF0ZSBDQSAodGVz\ndCBvbmx5KTBZMBMGByqGSM49AgEGCCqGSM49AwEHA0IABMZh1dDxEUeafTzP4soW\nLWOhE0a7we3pTRAAyl/+cJ8/Z9HeaGLLAjImI2qA41ibSy4UgPC4Zd5t1JcODsiw\nD0OjZjBkMBIGA1UdEwEB/wQIMAYBAf8CAQAwDgYDVR0PAQH/BAQDAgGGMB0GA1Ud\nDgQWBBRtNX5JQhk2je0jP2uYcU2JKK3acjAfBgNVHSMEGDAWgBTDInTmXv/SGk0Z\nuBTFfdHvoGm7mDAKBggqhkjOPQQDAgNJADBGAiEA7FjXOTvWLL10wTRQDoWRz7H2\n16hs+ZAfaRKkNjVdMn0CIQCEuJCnGcuHgwnCrqdkCH7QbILoVQqmeYPre5xmpbUH\n+w==\n-----END CERTIFICATE-----\n"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CertificateDecoderResponse"
                },
                "example": {
                  "tool": "certificate-decoder",
                  "target": "",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 0,
                  "summary": "Decoded 2 certificates, a chain from www.example.com to DNS Super Test Intermediate CA (test only). The leaf is valid until 2027-01-13 (60 days left).",
                  "findings": [
                    {
                      "id": "cert.chain_ends_at_intermediate",
                      "severity": "info",
                      "title": "The bundle stops at an intermediate certificate",
                      "detail": "The last one is Certificate 2 (DNS Super Test Intermediate CA (test only)).",
                      "fix": "Nothing to do; servers send intermediates and browsers hold the roots."
                    }
                  ],
                  "data": {
                    "items": [
                      {
                        "kind": "certificate",
                        "index": 0,
                        "subject": "CN=www.example.com,C=US",
                        "issuer": "CN=DNS Super Test Intermediate CA (test only),O=DNS Super Test CA,C=US",
                        "common_name": "www.example.com",
                        "serial_hex": "94eda",
                        "not_before": "2026-10-15T10:00:00Z",
                        "not_after": "2027-01-13T10:00:00Z",
                        "days_left": 60,
                        "validity_days": 90,
                        "names": {
                          "dns": [
                            "www.example.com",
                            "example.com"
                          ],
                          "ip": [],
                          "email": [],
                          "uri": []
                        },
                        "key": {
                          "type": "EC",
                          "bits": 256,
                          "curve": "secp256r1"
                        },
                        "signature_algorithm": "ecdsa-with-SHA256",
                        "signature_hash": "sha256",
                        "key_usage": [
                          "digital_signature"
                        ],
                        "extended_key_usage": [
                          "serverAuth"
                        ],
                        "ca": false,
                        "self_signed": false,
                        "ski": "cfe98736bcaebd1495f33f41d182c0151045e9ef",
                        "aki": "6d357e494219368ded233f6b98714d8928adda72",
                        "ocsp": [
                          "http://ocsp.example.net"
                        ],
                        "ca_issuers": [
                          "http://ca.example.net/int.der"
                        ],
                        "crl": [
                          "http://crl.example.net/int.crl"
                        ],
                        "policies": {
                          "oids": [
                            "2.23.140.1.2.1"
                          ],
                          "validation": "dv"
                        },
                        "scts": [],
                        "sha256": "63bb912fc10e362b1805d4b4efee0926584df227e1849ea77a904170599887fc",
                        "sha1": "a8050d9d36fc92bc4d63f212813dd9bd492d9d84",
                        "version": 3
                      },
                      {
                        "kind": "certificate",
                        "index": 1,
                        "subject": "CN=DNS Super Test Intermediate CA (test only),O=DNS Super Test CA,C=US",
                        "issuer": "CN=DNS Super Test Root CA (test only),O=DNS Super Test CA,C=US",
                        "common_name": "DNS Super Test Intermediate CA (test only)",
                        "serial_hex": "61000002",
                        "not_before": "2025-01-01T00:00:00Z",
                        "not_after": "2035-01-01T00:00:00Z",
                        "days_left": 2969,
                        "validity_days": 3652,
                        "names": {
                          "dns": [],
                          "ip": [],
                          "email": [],
                          "uri": []
                        },
                        "key": {
                          "type": "EC",
                          "bits": 256,
                          "curve": "secp256r1"
                        },
                        "signature_algorithm": "ecdsa-with-SHA256",
                        "signature_hash": "sha256",
                        "key_usage": [
                          "digital_signature",
                          "key_cert_sign",
                          "crl_sign"
                        ],
                        "extended_key_usage": [],
                        "ca": true,
                        "path_length": 0,
                        "self_signed": false,
                        "ski": "6d357e494219368ded233f6b98714d8928adda72",
                        "aki": "c32274e65effd21a4d19b814c57dd1efa069bb98",
                        "ocsp": [],
                        "ca_issuers": [],
                        "crl": [],
                        "policies": {
                          "oids": []
                        },
                        "scts": [],
                        "sha256": "fe671c6e0ee515625f0a900b95c424604620df9d934d6b24ce2b7082d6df7252",
                        "sha1": "3ad381dd72466b080d75302211d2d48bacc09cbe",
                        "version": 3
                      }
                    ],
                    "chain": {
                      "order": [
                        0,
                        1
                      ],
                      "links": [
                        {
                          "child": 0,
                          "parent": 1,
                          "signed": true
                        }
                      ],
                      "ends_at": "intermediate",
                      "reordered": false
                    }
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ],
        "x-dnssuper-tool": "certificate-decoder",
        "x-dnssuper-price": "Free; any API key works and nothing is charged. What you paste is processed in memory and never stored.",
        "x-dnssuper-cache": "Never cached; every call runs again.",
        "x-dnssuper-mcp": {
          "tool": "decode_certificate",
          "example": "Decoded 2 certificates, a chain from www.example.com to DNS Super Test Intermediate CA (test only). The leaf is valid until 2027-01-13 (60 days left).\nCertificate 1: www.example.com, issued by DNS Super Test Intermediate CA (test only), valid until 2027-01-13 (60 days left); EC 256; 2 names\nCertificate 2: DNS Super Test Intermediate CA (test only) (CA), issued by DNS Super Test Root CA (test only), valid until 2035-01-01 (2969 days left); EC 256\nChain: 1 > 2, ends at an intermediate\n- info: The bundle stops at an intermediate certificate\nFree | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/ip": {
      "get": {
        "tags": [
          "Certificates and network"
        ],
        "summary": "IP and network info",
        "description": "Reverse DNS with forward confirmation, the announcing network (origin AS, prefix, MOAS) and the allocating registry of a public IP address. Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached per account for up to 1 hour; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_ip_lookup",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "address",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 2,
              "maxLength": 45,
              "description": "A public IPv4 or IPv6 address.",
              "examples": [
                "192.0.2.1"
              ],
              "x-mono": true,
              "title": "Address"
            },
            "description": "A public IPv4 or IPv6 address."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/IpLookupResponse"
                },
                "example": {
                  "tool": "ip-lookup",
                  "target": "192.0.2.25",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 1,
                  "summary": "192.0.2.25 is announced by AS64496 (EXAMPLE-NET, NL) in 192.0.2.0/24. It reverses to mail.example.com, which points back to it.",
                  "findings": [],
                  "data": {
                    "address": "192.0.2.25",
                    "version": 4,
                    "scope": "documentation",
                    "ptr": {
                      "name": "mail.example.com",
                      "forward_confirmed": true,
                      "status": "found"
                    },
                    "registry": "arin",
                    "rdap_checked": false,
                    "route": {
                      "prefix": "192.0.2.0/24",
                      "origins": [
                        {
                          "number": 64496,
                          "name": "EXAMPLE-NET",
                          "description": "Example Network Ltd",
                          "country": "NL",
                          "reserved": false
                        }
                      ],
                      "moas": false,
                      "peers": 300,
                      "covering": []
                    },
                    "allocation": {
                      "registry": "arin",
                      "country": "US",
                      "date": "2004-03-01",
                      "status": "allocated",
                      "block": "192.0.2.0/24"
                    },
                    "routing_checked": true,
                    "table": {
                      "built_at": "2026-11-14T04:40:00Z",
                      "age_hours": 5
                    }
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "x-dnssuper-tool": "ip-lookup",
        "x-dnssuper-price": "Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached per account for up to 1 hour; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "lookup_ip",
          "example": "192.0.2.25 is announced by AS64496 (EXAMPLE-NET, NL) in 192.0.2.0/24. It reverses to mail.example.com, which points back to it.\nNetwork: AS64496 EXAMPLE-NET (NL), prefix 192.0.2.0/24\nAllocated: ARIN, 2004-03-01\nReverse DNS: mail.example.com (points back to the address)\nRegistry: ARIN\nNo issues found.\nCredits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/asn": {
      "get": {
        "tags": [
          "Certificates and network"
        ],
        "summary": "ASN and IP ownership",
        "description": "The announced prefixes, origin AS, holder and allocation for an IP address, a domain's addresses or an AS number. Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. Never cached; every call runs again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_asn_lookup",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "query",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 253,
              "description": "An IP address, a domain, or an AS number such as AS64496.",
              "examples": [
                "AS64496"
              ],
              "x-mono": true,
              "title": "Query"
            },
            "description": "An IP address, a domain, or an AS number such as AS64496."
          },
          {
            "name": "detail",
            "in": "query",
            "required": false,
            "schema": {
              "enum": [
                "summary",
                "full"
              ],
              "type": "string",
              "description": "full lists up to 2000 announced prefixes instead of 200.",
              "x-advanced": true,
              "default": "summary",
              "title": "Detail"
            },
            "description": "full lists up to 2000 announced prefixes instead of 200."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/AsnLookupResponse"
                },
                "example": {
                  "tool": "asn-lookup",
                  "target": "AS64496",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 1,
                  "summary": "AS64496 is EXAMPLE-NET (Example Network Ltd), registered with ARIN in NL. It announces 1 IPv4 prefix and 1 IPv6 prefix.",
                  "findings": [],
                  "data": {
                    "kind": "asn",
                    "query": "AS64496",
                    "addresses": [],
                    "asn": {
                      "number": 64496,
                      "name": "EXAMPLE-NET",
                      "description": "Example Network Ltd",
                      "country": "NL",
                      "reserved": false
                    },
                    "asn_allocation": {
                      "registry": "arin",
                      "country": "US",
                      "date": "2004-03-01",
                      "status": "assigned",
                      "block": "AS64496"
                    },
                    "prefixes": [
                      "192.0.2.0/24",
                      "2001:db8::/32"
                    ],
                    "prefixes_v4": 1,
                    "prefixes_v6": 1,
                    "ipv4_addresses": 256,
                    "truncated": false,
                    "table": {
                      "built_at": "2026-11-14T04:40:00Z",
                      "age_hours": 5
                    }
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "asn-lookup",
        "x-dnssuper-price": "Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Never cached; every call runs again.",
        "x-dnssuper-mcp": {
          "tool": "lookup_asn",
          "example": "AS64496 is EXAMPLE-NET (Example Network Ltd), registered with ARIN in NL. It announces 1 IPv4 prefix and 1 IPv6 prefix.\nAS64496 EXAMPLE-NET (Example Network Ltd), NL\nRegistry: ARIN, 2004-03-01\nPrefixes: 1 IPv4 (256 addresses), 1 IPv6\n192.0.2.0/24\n2001:db8::/32\nNo issues found.\nCredits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/ipv6": {
      "get": {
        "tags": [
          "Certificates and network"
        ],
        "summary": "IPv6 readiness",
        "description": "IPv6 readiness of a domain's website, mail servers and nameservers: AAAA records and, when our IPv6 connection is up, probes over IPv4 and IPv6. Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 15 minutes; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_ipv6_test",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 253,
              "description": "A domain; its website, mail servers and nameservers are checked.",
              "examples": [
                "example.com"
              ],
              "title": "Domain"
            },
            "description": "A domain; its website, mail servers and nameservers are checked."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Ipv6TestResponse"
                },
                "example": {
                  "tool": "ipv6-test",
                  "target": "example.com",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 1,
                  "summary": "example.com is fully reachable over IPv6.",
                  "findings": [
                    {
                      "id": "ipv6.ready",
                      "severity": "pass",
                      "title": "Your domain is fully reachable over IPv6",
                      "detail": "",
                      "fix": "Nothing to do."
                    }
                  ],
                  "data": {
                    "domain": "example.com",
                    "readiness": "full",
                    "grade_basis": "probes",
                    "probes": "checked",
                    "hosts": [
                      {
                        "name": "example.com",
                        "role": "web",
                        "ipv4": [
                          "192.0.2.10"
                        ],
                        "ipv6": [
                          "2001:db8::10"
                        ],
                        "ipv6_kinds": {
                          "2001:db8::10": "public"
                        },
                        "probe": {
                          "family6": {
                            "status": 200,
                            "title": "Example Domain",
                            "ms": 0
                          },
                          "family4": {
                            "status": 200,
                            "title": "Example Domain",
                            "ms": 0
                          },
                          "same": true
                        },
                        "ns_probes": []
                      },
                      {
                        "name": "www.example.com",
                        "role": "www",
                        "ipv4": [
                          "192.0.2.10"
                        ],
                        "ipv6": [
                          "2001:db8::10"
                        ],
                        "ipv6_kinds": {
                          "2001:db8::10": "public"
                        },
                        "probe": {
                          "family6": {
                            "status": 200,
                            "title": "Example Domain",
                            "ms": 0
                          },
                          "family4": {
                            "status": 200,
                            "title": "Example Domain",
                            "ms": 0
                          },
                          "same": true
                        },
                        "ns_probes": []
                      },
                      {
                        "name": "mail.example.com",
                        "role": "mx",
                        "ipv4": [
                          "192.0.2.25"
                        ],
                        "ipv6": [
                          "2001:db8::25"
                        ],
                        "ipv6_kinds": {
                          "2001:db8::25": "public"
                        },
                        "ns_probes": []
                      },
                      {
                        "name": "ns1.example.net",
                        "role": "ns",
                        "ipv4": [
                          "192.0.2.53"
                        ],
                        "ipv6": [
                          "2001:db8::53"
                        ],
                        "ipv6_kinds": {
                          "2001:db8::53": "public"
                        },
                        "ns_probes": [
                          {
                            "address": "2001:db8::53",
                            "answered": true,
                            "authoritative": true,
                            "serial": 2026111401,
                            "ms": 0
                          }
                        ]
                      },
                      {
                        "name": "ns2.example.net",
                        "role": "ns",
                        "ipv4": [
                          "198.51.100.53"
                        ],
                        "ipv6": [
                          "2001:db8:1000::53"
                        ],
                        "ipv6_kinds": {
                          "2001:db8:1000::53": "public"
                        },
                        "ns_probes": [
                          {
                            "address": "2001:db8:1000::53",
                            "answered": true,
                            "authoritative": true,
                            "serial": 2026111401,
                            "ms": 0
                          }
                        ]
                      }
                    ]
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "ipv6-test",
        "x-dnssuper-price": "Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for up to 15 minutes; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "check_ipv6",
          "example": "example.com is fully reachable over IPv6.\nReadiness: full (tested over IPv6)\nexample.com (web): IPv6 2001:db8::10, answers the same as over IPv4\nwww.example.com (www): IPv6 2001:db8::10, answers the same as over IPv4\nmail.example.com (mx): IPv6 2001:db8::25\nns1.example.net (ns): IPv6 2001:db8::53, answers authoritatively\nns2.example.net (ns): IPv6 2001:db8:1000::53, answers authoritatively\n1 check passed\nCredits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/ports": {
      "get": {
        "tags": [
          "Certificates and network"
        ],
        "summary": "Web port check",
        "description": "Whether ports 80 and 443 answer on each of a domain's addresses, with the TLS handshake and HTTP redirect for open ports. Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free. Answers are cached for up to 1 minute; send fresh=true to ask the source again. A retry with the same `X-Request-Id` returns the stored result of the first call for 24 hours without charging again, marked with the `X-Replayed: true` header.",
        "operationId": "run_port_checker",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "domain",
            "in": "query",
            "required": true,
            "schema": {
              "type": "string",
              "minLength": 1,
              "maxLength": 253,
              "description": "A domain; never an IP address. Ports 80 and 443 are checked on each of its addresses.",
              "examples": [
                "example.com"
              ],
              "title": "Domain"
            },
            "description": "A domain; never an IP address. Ports 80 and 443 are checked on each of its addresses."
          },
          {
            "name": "fresh",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Skip the cache and ask the source again; costs the same.",
              "default": false,
              "title": "Fresh"
            },
            "description": "Skip the cache and ask the source again; costs the same."
          }
        ],
        "responses": {
          "200": {
            "description": "The result",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PortCheckerResponse"
                },
                "example": {
                  "tool": "port-checker",
                  "target": "example.com",
                  "status": "ok",
                  "fetched_at": "2026-11-14T10:00:00Z",
                  "cached": false,
                  "credits_used": 1,
                  "summary": "Ports 80 and 443 answer on all 3 addresses of example.com.",
                  "findings": [
                    {
                      "id": "ports.all_open",
                      "severity": "pass",
                      "title": "Ports 80 and 443 answer on every address",
                      "detail": "",
                      "fix": "Nothing to do."
                    }
                  ],
                  "data": {
                    "host": "example.com",
                    "rows": [
                      {
                        "address": "192.0.2.10",
                        "family": 4,
                        "ports": {
                          "80": {
                            "state": "open",
                            "ms": 0,
                            "http": {
                              "status": 301,
                              "redirect_to": "https://example.com"
                            }
                          },
                          "443": {
                            "state": "open",
                            "ms": 0,
                            "tls": {
                              "ok": true,
                              "version": "TLSv1.3",
                              "name_matches": true
                            }
                          }
                        }
                      },
                      {
                        "address": "198.51.100.10",
                        "family": 4,
                        "ports": {
                          "80": {
                            "state": "open",
                            "ms": 0,
                            "http": {
                              "status": 301,
                              "redirect_to": "https://example.com"
                            }
                          },
                          "443": {
                            "state": "open",
                            "ms": 0,
                            "tls": {
                              "ok": true,
                              "version": "TLSv1.3",
                              "name_matches": true
                            }
                          }
                        }
                      },
                      {
                        "address": "2001:db8::10",
                        "family": 6,
                        "ports": {
                          "80": {
                            "state": "open",
                            "ms": 0,
                            "http": {
                              "status": 301,
                              "redirect_to": "https://example.com"
                            }
                          },
                          "443": {
                            "state": "open",
                            "ms": 0,
                            "tls": {
                              "ok": true,
                              "version": "TLSv1.3",
                              "name_matches": true
                            }
                          }
                        }
                      }
                    ],
                    "omitted": 0,
                    "ipv6_checked": true
                  },
                  "credits_remaining": 498
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "Every upstream source failed; not charged (`source_unavailable`). A Retry-After header says how long to wait when the source asked us to",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          }
        },
        "x-dnssuper-tool": "port-checker",
        "x-dnssuper-price": "Costs 1 credit per call; cached answers cost the same. Calls that fail upstream (502) are free.",
        "x-dnssuper-cache": "Answers are cached for up to 1 minute; send fresh=true to ask the source again.",
        "x-dnssuper-mcp": {
          "tool": "check_web_ports",
          "example": "Ports 80 and 443 answer on all 3 addresses of example.com.\nHost: example.com (3 addresses tested)\n192.0.2.10 (IPv4): 443 open, TLSv1.3; 80 open, redirects to https://example.com\n198.51.100.10 (IPv4): 443 open, TLSv1.3; 80 open, redirects to https://example.com\n2001:db8::10 (IPv6): 443 open, TLSv1.3; 80 open, redirects to https://example.com\n1 check passed\nCredits: 1 credit used, 498 remaining | fresh | checked 2026-11-14 10:00 UTC\n"
        }
      }
    },
    "/v1/streams": {
      "post": {
        "tags": [
          "Streams"
        ],
        "summary": "Start a streamed tool call",
        "description": "Start a tool call whose result arrives section by section over server-sent events. The body names the tool (`dns-lookup`) and its input, the same parameters as the tool's own endpoint (`domain`, `types`); `fresh` skips the cache. Input, credits and limits are checked before the 202, so those errors come back here as normal JSON errors. Then open `stream_url` (an `EventSource` works; no API key needed, the stream id is the access). The call costs what the tool's own endpoint costs and is charged once, when the result is complete, whether or not anyone is listening. A retry with the same `X-Request-Id` gets a stream holding only the stored result, marked `replayed`, with no new charge.",
        "operationId": "create_stream_v1_streams_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/StreamRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "202": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StreamCreated"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "413": {
            "description": "The body is larger than 64 KiB (`invalid_request`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/streams/{stream_id}": {
      "get": {
        "tags": [
          "Streams"
        ],
        "summary": "Events of a streamed tool call",
        "description": "Server-sent events for one run. Events, each with a JSON object in `data`:\n\n- `started`: `{tool, target, request_id}`\n- `section`: `{section, data}`, e.g. `section` `records` with `data` `{type, status, records}` for each DNS record type as soon as it is in\n- `result` (last): the tool endpoint's 200 body plus `replayed`\n- `error` (last): the error body, e.g. `source_unavailable` (not charged)\n\nSend `Last-Event-ID` to resume after an event. Comments (`: keepalive`) keep quiet connections open. Streams expire 10 minutes after their last event.",
        "operationId": "get_stream_v1_streams__stream_id__get",
        "parameters": [
          {
            "name": "stream_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "description": "`stream_id` from POST /v1/streams",
              "title": "Stream Id"
            },
            "description": "`stream_id` from POST /v1/streams"
          },
          {
            "name": "Last-Event-ID",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "description": "Resume after this event id (browsers send it when they reconnect)",
              "title": "Last-Event-Id"
            },
            "description": "Resume after this event id (browsers send it when they reconnect)"
          }
        ],
        "responses": {
          "200": {
            "description": "The run's events, ending with `result` or `error`",
            "content": {
              "text/event-stream": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "headers": {
              "Access-Control-Allow-Origin": {
                "description": "The website's origin, so browsers can open the stream",
                "schema": {
                  "type": "string"
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such job or stream, or it has expired (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/streams/{stream_id}/result": {
      "get": {
        "tags": [
          "Streams"
        ],
        "summary": "Result of a streamed tool call",
        "description": "The events a streamed call has published so far, as JSON, for clients whose event stream stalled or dropped. When the last event (`result` or `error`) is already there, the answer is immediate with `done: true`; otherwise it waits up to `wait` seconds for it. No API key needed (the stream id is the access). Never charges and never runs the call again.",
        "operationId": "get_stream_result_v1_streams__stream_id__result_get",
        "parameters": [
          {
            "name": "stream_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "description": "`stream_id` from POST /v1/streams",
              "title": "Stream Id"
            },
            "description": "`stream_id` from POST /v1/streams"
          },
          {
            "name": "wait",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 25,
              "minimum": 0,
              "description": "Seconds to wait for the last event",
              "default": 20,
              "title": "Wait"
            },
            "description": "Seconds to wait for the last event"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/StreamResult"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such job or stream, or it has expired (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/jobs": {
      "get": {
        "tags": [
          "Jobs"
        ],
        "summary": "Your jobs",
        "description": "The account's jobs, newest first: tool jobs and bulk checks, with their progress, credits and estimated time left. Filter with `status` and `kind`; page with `cursor` (the `next_cursor` of the previous page). No charge.",
        "operationId": "read_jobs_v1_jobs_get",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 200
                },
                {
                  "type": "null"
                }
              ],
              "description": "`next_cursor` from the previous page",
              "title": "Cursor"
            },
            "description": "`next_cursor` from the previous page"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "description": "Jobs per page",
              "default": 25,
              "title": "Limit"
            },
            "description": "Jobs per page"
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/JobsStatusFilter",
              "description": "Which jobs to list",
              "default": "all"
            },
            "description": "Which jobs to list"
          },
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "schema": {
              "$ref": "#/components/schemas/JobsKindFilter",
              "description": "Tool jobs, bulk checks or both",
              "default": "all"
            },
            "description": "Tool jobs, bulk checks or both"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobsPage"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/jobs/{job_id}": {
      "get": {
        "tags": [
          "Jobs"
        ],
        "summary": "Job status",
        "description": "Progress and credits of a job. `credits_reserved` were held when it was submitted; `credits_used` counts rows with a result (failed and skipped rows are free), and the rest of the reservation returns to your balance when the job ends. No charge.",
        "operationId": "read_job_v1_jobs__job_id__get",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 64,
              "description": "The job's ID",
              "title": "Job Id"
            },
            "description": "The job's ID"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobResponse"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such job or stream, or it has expired (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/jobs/{job_id}/items": {
      "get": {
        "tags": [
          "Jobs"
        ],
        "summary": "Job rows and results",
        "description": "A job's rows in order, with each row's status, credits, error and result envelope. Page with `after` (the last row you have) and `limit`; results are kept for 7 days. No charge.",
        "operationId": "read_job_items_v1_jobs__job_id__items_get",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 64,
              "description": "The job's ID",
              "title": "Job Id"
            },
            "description": "The job's ID"
          },
          {
            "name": "after",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "minimum": 0,
              "description": "Return rows after this row number",
              "default": 0,
              "title": "After"
            },
            "description": "Return rows after this row number"
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "description": "Rows per page",
              "default": 50,
              "title": "Limit"
            },
            "description": "Rows per page"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobItemsResponse"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such job or stream, or it has expired (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/jobs/{job_id}/cancel": {
      "post": {
        "tags": [
          "Jobs"
        ],
        "summary": "Cancel a job",
        "description": "Stops a queued or running job: rows already done stay charged, the rest are skipped and their held credits return to your balance. The job shows `cancelling` until the worker settles it. Cancelling a finished job returns it unchanged. No charge.",
        "operationId": "cancel_v1_jobs__job_id__cancel_post",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 64,
              "description": "The job's ID",
              "title": "Job Id"
            },
            "description": "The job's ID"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobResponse"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such job or stream, or it has expired (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/jobs/{job_id}/events": {
      "get": {
        "tags": [
          "Jobs"
        ],
        "summary": "Job events",
        "description": "Server-sent events for a job: `progress` with `{done, failed, total}` after each row, then one `done` event with the job (as `GET /v1/jobs/{id}`), after which the stream ends. A finished job's stream sends `done` at once. Reconnect with `Last-Event-ID` to resume. No charge.",
        "operationId": "job_events_v1_jobs__job_id__events_get",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "job_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 64,
              "description": "The job's ID",
              "title": "Job Id"
            },
            "description": "The job's ID"
          },
          {
            "name": "Last-Event-ID",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 64
                },
                {
                  "type": "null"
                }
              ],
              "description": "Resume after this event",
              "title": "Last-Event-Id"
            },
            "description": "Resume after this event"
          }
        ],
        "responses": {
          "200": {
            "description": "A text/event-stream of `progress` events and a final `done` event",
            "content": {
              "text/event-stream": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such job or stream, or it has expired (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/bulk/{tool}": {
      "post": {
        "tags": [
          "Bulk"
        ],
        "summary": "Bulk check",
        "description": "Check many rows in one job. Send JSON with exactly one of `targets` (names), `rows` (objects of the tool's own inputs) or `csv` (a CSV file's text with a header row), or upload the file itself as `text/csv` with job-wide options as query parameters. `options` apply to every row; `fresh`, variant and per-unit options are job-wide only. Every row is checked before anything is charged: with `dry_run=true` the answer lists the columns, the row errors (with line numbers), a preview, the credits the job would hold and the longest time it could take, and nothing is reserved. Add `skip_invalid=true` to run only the valid rows. The job holds the price of every row and charges only rows that get a result. Follow it at `job_url`, read results at `items_url`, cancel it with `POST /v1/jobs/{id}/cancel`, or get a notice on an alert channel with `notify`. Bulk checks unlock after your first credit purchase or plan.",
        "operationId": "bulk_check_v1_bulk__tool__post",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "tool",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 64,
              "description": "Registry id of the tool",
              "title": "Tool"
            },
            "description": "Registry id of the tool"
          },
          {
            "name": "dry_run",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            },
            "description": "Show the rows, errors, credits and time without starting the job"
          },
          {
            "name": "skip_invalid",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "default": false
            },
            "description": "Run only the valid rows instead of refusing the job"
          }
        ],
        "responses": {
          "200": {
            "description": "`dry_run=true`: what the job would do",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/BulkDryRunResponse"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "202": {
            "description": "The job started",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/JobStartResponse"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "The tool has no bulk checks, too many or no rows, invalid rows (listed in `error.details.errors`), an unknown or job-wide column, or a list that can't finish in time (`invalid_request`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Balance below the call's price (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "The website's key without a signed-in user, an account without a credit purchase or paid plan yet, or a dangling-record check without the TXT ownership records (`sign_in_required`, `bulk_locked`, `verification_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "413": {
            "description": "The body is larger than 2 MiB of JSON, or 1 MiB as `text/csv` (`invalid_request`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "More than 10 bulk checks or 30 previews in an hour, 3 unfinished bulk checks, or too many `fresh` calls; wait for the seconds in Retry-After (`rate_limited`, `too_many_jobs`)",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "503": {
            "description": "Bulk checks are busy site-wide; try again after Retry-After (`bulk_busy`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "additionalProperties": false,
                "description": "Exactly one of `targets`, `rows` or `csv`.",
                "properties": {
                  "targets": {
                    "anyOf": [
                      {
                        "items": {},
                        "type": "array"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Names to check, one per row",
                    "examples": [
                      [
                        "brightidea.io",
                        "brightidea.fr"
                      ]
                    ],
                    "title": "Targets"
                  },
                  "rows": {
                    "anyOf": [
                      {
                        "items": {
                          "additionalProperties": true,
                          "type": "object"
                        },
                        "type": "array"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Rows of the tool's own input properties",
                    "title": "Rows"
                  },
                  "csv": {
                    "anyOf": [
                      {
                        "maxLength": 1048576,
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "The text of a CSV file: a header naming the tool's inputs, one row per check",
                    "title": "Csv"
                  },
                  "options": {
                    "additionalProperties": true,
                    "description": "Job-wide parameters for every row: `fresh`, variant and per-unit options, and any shared tool parameter",
                    "title": "Options",
                    "type": "object"
                  },
                  "label": {
                    "anyOf": [
                      {
                        "maxLength": 80,
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Your name for the job",
                    "title": "Label"
                  },
                  "notify": {
                    "anyOf": [
                      {
                        "additionalProperties": false,
                        "properties": {
                          "channel_id": {
                            "description": "An alert channel of your account",
                            "format": "uuid",
                            "title": "Channel Id",
                            "type": "string"
                          }
                        },
                        "required": [
                          "channel_id"
                        ],
                        "title": "BulkNotify",
                        "type": "object"
                      },
                      {
                        "type": "null"
                      }
                    ],
                    "description": "Send a notice to this alert channel when the job finishes"
                  },
                  "check_ownership": {
                    "default": false,
                    "description": "Dry runs only: also check the TXT ownership records (subdomain takeover)",
                    "title": "Check Ownership",
                    "type": "boolean"
                  }
                },
                "title": "BulkRequest",
                "type": "object"
              }
            },
            "text/csv": {
              "schema": {
                "type": "string"
              },
              "example": "domain\nbrightidea.io\nbrightidea.fr\n"
            }
          }
        }
      }
    },
    "/v1/shares": {
      "post": {
        "tags": [
          "Shared reports"
        ],
        "summary": "Share a result",
        "description": "Make a public link to a frozen copy of a result your account holds: a call's result (by its `X-Request-Id`, kept 24 hours) or a job row (kept 7 days). The link expires after `expires_in_days` (1 to 90, default 30) and can have a password. Sending the same `X-Request-Id` again returns the same link (200). Free; no usage is recorded.",
        "operationId": "create_share_v1_shares_post",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateShareRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The link made earlier with this X-Request-Id",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Share"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Share"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "No API key or session, or an anonymous visitor (`unauthorized`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "The account is suspended, has 1,000 active links, or a member tried to revoke someone else's link (`account_suspended`, `plan_limit`, `forbidden`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such result or shared report in this account (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "Too many shared links made in the last hour (`rate_limited`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Shared reports"
        ],
        "summary": "Your shared links",
        "description": "The account's shared links, newest first. `state=active` (default) lists links that still open; `all` adds expired and revoked ones (their snapshots are already gone). Page with `cursor`. Free.",
        "operationId": "list_shares_v1_shares_get",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 200
                },
                {
                  "type": "null"
                }
              ],
              "title": "Cursor"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 50,
              "title": "Limit"
            }
          },
          {
            "name": "state",
            "in": "query",
            "required": false,
            "schema": {
              "enum": [
                "active",
                "all"
              ],
              "type": "string",
              "default": "active",
              "title": "State"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ShareList"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/shares/{share_id}": {
      "get": {
        "tags": [
          "Shared reports"
        ],
        "summary": "One shared link",
        "description": "A shared link of this account, with its views and state. Free.",
        "operationId": "read_share_v1_shares__share_id__get",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "share_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 64,
              "description": "The shared report's ID",
              "title": "Share Id"
            },
            "description": "The shared report's ID"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Share"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "No API key or session, or an anonymous visitor (`unauthorized`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "The account is suspended, has 1,000 active links, or a member tried to revoke someone else's link (`account_suspended`, `plan_limit`, `forbidden`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such result or shared report in this account (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "Too many shared links made in the last hour (`rate_limited`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Shared reports"
        ],
        "summary": "Revoke a shared link",
        "description": "Stops the link working at once and deletes its snapshot. Members revoke their own links, owners any link of the account. Revoking twice is fine. Free.",
        "operationId": "revoke_share_v1_shares__share_id__delete",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "share_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "maxLength": 64,
              "description": "The shared report's ID",
              "title": "Share Id"
            },
            "description": "The shared report's ID"
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response",
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "No API key or session, or an anonymous visitor (`unauthorized`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "The account is suspended, has 1,000 active links, or a member tried to revoke someone else's link (`account_suspended`, `plan_limit`, `forbidden`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such result or shared report in this account (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "Too many shared links made in the last hour (`rate_limited`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/account/events": {
      "get": {
        "tags": [
          "Account"
        ],
        "summary": "Account events",
        "description": "Server-sent events for your account: `usage` after every charged or free call (tool, usage target, credits, cached, status, duration), `job` when a job starts, makes progress or ends, and `monitor` when a monitor runs. Reconnect with `Last-Event-ID` to resume; without it the stream starts from now. At most 3 open per account. No charge.",
        "operationId": "account_events_v1_account_events_get",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "Last-Event-ID",
            "in": "header",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Last-Event-Id"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "The event stream",
            "content": {
              "text/event-stream": {}
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/monitors": {
      "get": {
        "tags": [
          "Monitors"
        ],
        "summary": "List monitors",
        "description": "Your account's monitors, oldest first, with the plan's limits.",
        "operationId": "list_monitors_v1_monitors_get",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 200
                },
                {
                  "type": "null"
                }
              ],
              "title": "Cursor"
            }
          },
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 20
                },
                {
                  "type": "null"
                }
              ],
              "title": "Kind"
            }
          },
          {
            "name": "health",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "ok",
                    "warn",
                    "fail",
                    "unknown"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Health"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "enum": [
                    "active",
                    "paused",
                    "limited"
                  ],
                  "type": "string"
                },
                {
                  "type": "null"
                }
              ],
              "title": "Status"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 50,
              "title": "Limit"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/MonitorList"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "Bad target or options, a selector that doesn't parse, or a jobs-only channel (`invalid_request`, `invalid_domain`, `invalid_url`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "Not allowed by your plan, or an anonymous visitor (`plan_limit`, `plan_kind`, `interval_not_allowed`, `channel_not_allowed`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      },
      "post": {
        "tags": [
          "Monitors"
        ],
        "summary": "Create a monitor",
        "description": "Start watching a domain or URL. The first check runs at once; checks are free. Send the same `X-Request-Id` again to get the monitor it already made (200).",
        "operationId": "create_monitor_v1_monitors_post",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateMonitor"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Made earlier with this X-Request-Id",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Monitor"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Monitor"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "Bad target or options, a selector that doesn't parse, or a jobs-only channel (`invalid_request`, `invalid_domain`, `invalid_url`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "Not allowed by your plan, or an anonymous visitor (`plan_limit`, `plan_kind`, `interval_not_allowed`, `channel_not_allowed`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such monitor or channel in this account (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "409": {
            "description": "The same monitor exists, an unverified webhook, or no members to email (`duplicate_monitor`, `channel_unverified`, `no_members`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "Too many creates, changes or checks (`rate_limited`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/monitors/{monitor_id}": {
      "get": {
        "tags": [
          "Monitors"
        ],
        "summary": "Get a monitor",
        "operationId": "get_monitor_v1_monitors__monitor_id__get",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "monitor_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "description": "The monitor's ID",
              "title": "Monitor Id"
            },
            "description": "The monitor's ID"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Monitor"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "Not allowed by your plan, or an anonymous visitor (`plan_limit`, `plan_kind`, `interval_not_allowed`, `channel_not_allowed`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such monitor or channel in this account (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      },
      "patch": {
        "tags": [
          "Monitors"
        ],
        "summary": "Change a monitor",
        "description": "Change the label, interval, options, alert rules, channels, or pause it. New options start a new baseline and count against the day's create limit.",
        "operationId": "update_monitor_v1_monitors__monitor_id__patch",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "monitor_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "description": "The monitor's ID",
              "title": "Monitor Id"
            },
            "description": "The monitor's ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateMonitor"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Monitor"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "Bad target or options, a selector that doesn't parse, or a jobs-only channel (`invalid_request`, `invalid_domain`, `invalid_url`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "Not allowed by your plan, or an anonymous visitor (`plan_limit`, `plan_kind`, `interval_not_allowed`, `channel_not_allowed`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such monitor or channel in this account (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "409": {
            "description": "The same monitor exists, an unverified webhook, or no members to email (`duplicate_monitor`, `channel_unverified`, `no_members`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "Too many creates, changes or checks (`rate_limited`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Monitors"
        ],
        "summary": "Delete a monitor",
        "description": "Deletes the monitor with its runs and events. Its plan slot is free at once.",
        "operationId": "delete_monitor_v1_monitors__monitor_id__delete",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "monitor_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "description": "The monitor's ID",
              "title": "Monitor Id"
            },
            "description": "The monitor's ID"
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response",
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "Not allowed by your plan, or an anonymous visitor (`plan_limit`, `plan_kind`, `interval_not_allowed`, `channel_not_allowed`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such monitor or channel in this account (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/monitors/{monitor_id}/check": {
      "post": {
        "tags": [
          "Monitors"
        ],
        "summary": "Check now",
        "description": "Run the monitor within about a minute. Free; 10 an hour per monitor and 60 an hour per account (lookalike monitors once a day). A check already running is left alone.",
        "operationId": "check_monitor_v1_monitors__monitor_id__check_post",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "monitor_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "description": "The monitor's ID",
              "title": "Monitor Id"
            },
            "description": "The monitor's ID"
          }
        ],
        "responses": {
          "202": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CheckAccepted"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "Not allowed by your plan, or an anonymous visitor (`plan_limit`, `plan_kind`, `interval_not_allowed`, `channel_not_allowed`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such monitor or channel in this account (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "Too many creates, changes or checks (`rate_limited`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/monitors/{monitor_id}/events": {
      "get": {
        "tags": [
          "Monitors"
        ],
        "summary": "List a monitor's events",
        "description": "Newest first.",
        "operationId": "list_events_v1_monitors__monitor_id__events_get",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "monitor_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "description": "The monitor's ID",
              "title": "Monitor Id"
            },
            "description": "The monitor's ID"
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 200
                },
                {
                  "type": "null"
                }
              ],
              "title": "Cursor"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 50,
              "title": "Limit"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/EventList"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "Bad target or options, a selector that doesn't parse, or a jobs-only channel (`invalid_request`, `invalid_domain`, `invalid_url`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "Not allowed by your plan, or an anonymous visitor (`plan_limit`, `plan_kind`, `interval_not_allowed`, `channel_not_allowed`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such monitor or channel in this account (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/monitors/{monitor_id}/uptime": {
      "get": {
        "tags": [
          "Monitors"
        ],
        "summary": "A monitor's uptime",
        "description": "Daily checks and answers of an uptime monitor over the last 7, 30 or 90 days.",
        "operationId": "uptime_v1_monitors__monitor_id__uptime_get",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "monitor_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "description": "The monitor's ID",
              "title": "Monitor Id"
            },
            "description": "The monitor's ID"
          },
          {
            "name": "days",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "description": "7, 30 or 90",
              "default": 30,
              "title": "Days"
            },
            "description": "7, 30 or 90"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/UptimeView"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "Bad target or options, a selector that doesn't parse, or a jobs-only channel (`invalid_request`, `invalid_domain`, `invalid_url`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "Not allowed by your plan, or an anonymous visitor (`plan_limit`, `plan_kind`, `interval_not_allowed`, `channel_not_allowed`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such monitor or channel in this account (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/alert-channels": {
      "get": {
        "tags": [
          "Alert channels"
        ],
        "summary": "List alert channels",
        "operationId": "list_channels_v1_alert_channels_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChannelList"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "Not in your plan, or an anonymous visitor (`channel_not_allowed`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      },
      "post": {
        "tags": [
          "Alert channels"
        ],
        "summary": "Create an alert channel",
        "description": "Email (to members of this account), a signed webhook, or a Slack incoming webhook. Webhooks start unverified: call /verify once your endpoint echoes the challenge. The signing secret is shown once.",
        "operationId": "create_channel_v1_alert_channels_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CreateChannel"
              }
            }
          },
          "required": true
        },
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ChannelCreated"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "Bad URL or recipients (`invalid_request`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "Not in your plan, or an anonymous visitor (`channel_not_allowed`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "409": {
            "description": "20 channels already, alert delivery off, or an unverified webhook (`channel_limit`, `alerts_off`, `channel_unverified`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/alert-channels/{channel_id}": {
      "patch": {
        "tags": [
          "Alert channels"
        ],
        "summary": "Change an alert channel",
        "description": "Rename, change the URL or recipients, the digest, or pause it. Resuming resets the failure count; a new webhook URL must be verified again.",
        "operationId": "update_channel_v1_alert_channels__channel_id__patch",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "channel_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "description": "The alert channel's ID",
              "title": "Channel Id"
            },
            "description": "The alert channel's ID"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/UpdateChannel"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Channel"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "Bad URL or recipients (`invalid_request`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "Not in your plan, or an anonymous visitor (`channel_not_allowed`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such channel in this account (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Alert channels"
        ],
        "summary": "Delete an alert channel",
        "operationId": "delete_channel_v1_alert_channels__channel_id__delete",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "channel_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "description": "The alert channel's ID",
              "title": "Channel Id"
            },
            "description": "The alert channel's ID"
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response",
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "Not in your plan, or an anonymous visitor (`channel_not_allowed`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such channel in this account (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/alert-channels/{channel_id}/verify": {
      "post": {
        "tags": [
          "Alert channels"
        ],
        "summary": "Verify a webhook endpoint",
        "description": "Sends one signed POST `{\"type\": \"endpoint.verify\", \"challenge\": \"...\"}`; the channel becomes active when the response body contains the challenge. 5 an hour per channel.",
        "operationId": "verify_channel_v1_alert_channels__channel_id__verify_post",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "channel_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "description": "The alert channel's ID",
              "title": "Channel Id"
            },
            "description": "The alert channel's ID"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VerifyResult"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "Not in your plan, or an anonymous visitor (`channel_not_allowed`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such channel in this account (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "409": {
            "description": "20 channels already, alert delivery off, or an unverified webhook (`channel_limit`, `alerts_off`, `channel_unverified`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "Too many test sends or verifications (`rate_limited`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/alert-channels/{channel_id}/test": {
      "post": {
        "tags": [
          "Alert channels"
        ],
        "summary": "Send a test alert",
        "description": "Queues one test delivery. 5 an hour per channel and 20 an hour per account.",
        "operationId": "test_channel_v1_alert_channels__channel_id__test_post",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "channel_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "description": "The alert channel's ID",
              "title": "Channel Id"
            },
            "description": "The alert channel's ID"
          }
        ],
        "responses": {
          "202": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeliveryView"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "Not in your plan, or an anonymous visitor (`channel_not_allowed`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such channel in this account (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "409": {
            "description": "20 channels already, alert delivery off, or an unverified webhook (`channel_limit`, `alerts_off`, `channel_unverified`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "Too many test sends or verifications (`rate_limited`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/alert-channels/{channel_id}/rotate-secret": {
      "post": {
        "tags": [
          "Alert channels"
        ],
        "summary": "Rotate a webhook's signing secret",
        "description": "The new secret is shown once; requests are signed with it from now on.",
        "operationId": "rotate_secret_v1_alert_channels__channel_id__rotate_secret_post",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "channel_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "description": "The alert channel's ID",
              "title": "Channel Id"
            },
            "description": "The alert channel's ID"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/SecretRotated"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "Not in your plan, or an anonymous visitor (`channel_not_allowed`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such channel in this account (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/alert-channels/{channel_id}/deliveries": {
      "get": {
        "tags": [
          "Alert channels"
        ],
        "summary": "A channel's delivery log",
        "description": "Newest first; the HTTP status class only (2xx, 3xx, 4xx, 5xx).",
        "operationId": "list_deliveries_v1_alert_channels__channel_id__deliveries_get",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "channel_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "description": "The alert channel's ID",
              "title": "Channel Id"
            },
            "description": "The alert channel's ID"
          },
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 200
                },
                {
                  "type": "null"
                }
              ],
              "title": "Cursor"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 50,
              "title": "Limit"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/DeliveryList"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "Bad URL or recipients (`invalid_request`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "Not in your plan, or an anonymous visitor (`channel_not_allowed`, `sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such channel in this account (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/calendar-feeds": {
      "get": {
        "tags": [
          "Calendar feeds"
        ],
        "summary": "Calendar feed state",
        "description": "Whether the account has an expiry calendar feed, when it was made and last fetched, and how many domain-expiry monitors it lists. Never returns the URL.",
        "operationId": "get_feed_v1_calendar_feeds_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarFeedState"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      },
      "post": {
        "tags": [
          "Calendar feeds"
        ],
        "summary": "Make or rotate the calendar feed",
        "description": "Make the account's expiry calendar feed URL, or replace it: the old URL stops working at once. The URL is returned only this time. Owners only (or a key the owner made). Free.",
        "operationId": "create_feed_v1_calendar_feeds_post",
        "responses": {
          "201": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CalendarFeedCreated"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      },
      "delete": {
        "tags": [
          "Calendar feeds"
        ],
        "summary": "Revoke the calendar feed",
        "description": "Turn the feed URL off. Idempotent. Owners only (or a key the owner made).",
        "operationId": "delete_feed_v1_calendar_feeds_delete",
        "responses": {
          "204": {
            "description": "Successful Response",
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/calendar-feeds/download": {
      "get": {
        "tags": [
          "Calendar feeds"
        ],
        "summary": "Download the monitored-domains calendar",
        "description": "The calendar the feed serves, as a one-off `.ics` download: one all-day event per domain-expiry monitor on its expiry date, with reminders 30 and 7 days before. Free.",
        "operationId": "download_feed_v1_calendar_feeds_download_get",
        "responses": {
          "200": {
            "description": "The calendar file",
            "content": {
              "text/calendar": {}
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/exports": {
      "post": {
        "tags": [
          "Exports"
        ],
        "summary": "Export a result",
        "description": "Export a result you hold: a call (by its `X-Request-Id`, kept 24 hours), a job or one of its rows (7 days), a compare, or a monitor's history. JSON, CSV and iCalendar files stream back at once and are never stored. A PDF is made in the background: the answer is 202 with the export, whose `status` becomes `done` within a minute or two; download it from `file_url` (kept 24 hours). Sending the same `X-Request-Id` again returns the same export. Formats follow the tool: registration lookups export JSON and CSV only, iCalendar only from expiry calendars. On the Agency plan PDFs carry your branding. Free; at most 60 exports and 5 PDFs (20 on paid plans) an hour.",
        "operationId": "create_export_v1_exports_post",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/ExportRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The file (JSON, CSV or iCalendar)",
            "content": {
              "application/json": {
                "schema": {}
              },
              "text/csv": {
                "schema": {
                  "type": "string"
                }
              },
              "text/calendar": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "202": {
            "description": "A PDF export started",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExportView"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such job or stream, or it has expired (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "503": {
            "description": "Too many open event streams on this server, the checked site is getting too many checks, or the browser or link checker is busy; try again after the seconds in the Retry-After header (`busy`, `site_busy`, `browser_busy`, `crawl_busy`). Not charged",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      },
      "get": {
        "tags": [
          "Exports"
        ],
        "summary": "Your PDF exports",
        "description": "The account's PDF exports, newest first, with their status. No charge.",
        "operationId": "list_exports_v1_exports_get",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "cursor",
            "in": "query",
            "required": false,
            "schema": {
              "anyOf": [
                {
                  "type": "string",
                  "maxLength": 200
                },
                {
                  "type": "null"
                }
              ],
              "title": "Cursor"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "schema": {
              "type": "integer",
              "maximum": 100,
              "minimum": 1,
              "default": 25,
              "title": "Limit"
            }
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExportsPage"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/exports/{export_id}": {
      "get": {
        "tags": [
          "Exports"
        ],
        "summary": "A PDF export",
        "description": "One PDF export and its status. No charge.",
        "operationId": "read_export_v1_exports__export_id__get",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "export_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "description": "The export's ID",
              "title": "Export Id"
            },
            "description": "The export's ID"
          }
        ],
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ExportView"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such job or stream, or it has expired (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      },
      "delete": {
        "tags": [
          "Exports"
        ],
        "summary": "Delete a PDF export",
        "description": "Delete the export and its file now. Deleting twice is fine. No charge.",
        "operationId": "delete_export_v1_exports__export_id__delete",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "export_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "description": "The export's ID",
              "title": "Export Id"
            },
            "description": "The export's ID"
          }
        ],
        "responses": {
          "204": {
            "description": "Successful Response",
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/exports/{export_id}/file": {
      "get": {
        "tags": [
          "Exports"
        ],
        "summary": "Download a PDF export",
        "description": "The PDF of a finished export, kept 24 hours. No charge.",
        "operationId": "export_file_v1_exports__export_id__file_get",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "export_id",
            "in": "path",
            "required": true,
            "schema": {
              "type": "string",
              "format": "uuid",
              "description": "The export's ID",
              "title": "Export Id"
            },
            "description": "The export's ID"
          }
        ],
        "responses": {
          "200": {
            "description": "The PDF",
            "content": {
              "application/json": {
                "schema": {}
              },
              "application/pdf": {}
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "404": {
            "description": "No such job or stream, or it has expired (`not_found`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        }
      }
    },
    "/v1/verifications/record": {
      "post": {
        "tags": [
          "Bulk"
        ],
        "summary": "Ownership record",
        "description": "The TXT record that proves your account controls a domain, for bulk dangling-record checks. Publish it at `record_name` with the value `record_value`; one record covers every name under the registrable domain. Free; nothing is stored.",
        "operationId": "verification_record_v1_verifications_record_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VerificationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VerificationRecord"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/verifications/check": {
      "post": {
        "tags": [
          "Bulk"
        ],
        "summary": "Check an ownership record",
        "description": "Whether the TXT ownership record for a domain is published, asked of our resolver and then of the domain's own nameservers, so a record you just added counts. Free; at most 60 checks an hour.",
        "operationId": "verification_check_v1_verifications_check_post",
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/VerificationRequest"
              }
            }
          },
          "required": true
        },
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/VerificationCheck"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "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`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": [
          {
            "ApiKey": []
          }
        ]
      }
    },
    "/v1/compare": {
      "post": {
        "tags": [
          "Platform"
        ],
        "summary": "Compare domains",
        "description": "Run the same 1 to 4 tools on 2 to 4 domains and see the results side by side: every tool's result per domain (`cells`, tool order first), the findings lined up across the domains with the ones that differ first (`rows`), each graded tool's score per domain (`scores`) and a one-line summary. Each cell costs its tool's price, cached cells the same (ssl-checker at 1 plus email-checker at 2 on 3 domains is 9 credits); a cell that gets no answer costs nothing and carries an `error` instead of an `envelope`. The whole comparison is checked against your balance first (402) and charged once. With `stream=true` the answer is a 202 with an `events_url`: the total is held, each cell arrives as a `section` event (`cell`) as soon as it is in, and the last event is the `result`. A retry with the same `X-Request-Id` returns the stored comparison for 24 hours without charging again. Needs an account: the website's free checks don't cover it. At most 30 comparisons an hour.",
        "operationId": "compare_domains",
        "security": [
          {
            "ApiKey": []
          }
        ],
        "parameters": [
          {
            "name": "stream",
            "in": "query",
            "required": false,
            "schema": {
              "type": "boolean",
              "description": "Stream the cells over server-sent events (202)",
              "default": false,
              "title": "Stream"
            },
            "description": "Stream the cells over server-sent events (202)"
          }
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/CompareRequest"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "The comparison",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompareResponse"
                }
              }
            },
            "headers": {
              "X-Replayed": {
                "description": "Present and `true` when this is the stored result of an earlier call with the same X-Request-Id; nothing was charged this time",
                "schema": {
                  "type": "string",
                  "enum": [
                    "true"
                  ]
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "202": {
            "description": "`stream=true`: the run started",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/CompareStreamStart"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "400": {
            "description": "Not 2 to 4 domains or 1 to 4 tools, a repeated domain or tool, a tool that can't be compared (the message lists the ones that can), or a domain we can't look up (`invalid_request`, `invalid_domain`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "401": {
            "description": "Missing, unknown or revoked API key, or one whose creator is no longer a member of the account (`unauthorized`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "402": {
            "description": "Your balance is below the price of every cell together (`insufficient_credits`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "403": {
            "description": "The website's free checks don't cover compare; sign in (`sign_in_required`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "413": {
            "description": "The body is larger than 64 KiB (`invalid_request`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "More than 30 comparisons in an hour, or too many `fresh` cells; wait for the seconds in Retry-After (`rate_limited`)",
            "headers": {
              "Retry-After": {
                "description": "Seconds to wait before trying again",
                "schema": {
                  "type": "integer",
                  "minimum": 1
                }
              },
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            }
          },
          "500": {
            "description": "Unexpected error (`internal_error`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "502": {
            "description": "No cell got an answer from its sources; nothing was charged (`source_unavailable`)",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "x-dnssuper-tool": "compare",
        "x-dnssuper-mcp": {
          "tool": "compare_domains"
        }
      }
    },
    "/v1/status": {
      "get": {
        "tags": [
          "Status"
        ],
        "summary": "Service status",
        "description": "The current state of each part of DNS Super, 90 days of daily uptime, the last TLD canary run and open and recent incidents. Public: no key, no charge. Cached for 30 seconds.",
        "operationId": "get_status_v1_status_get",
        "responses": {
          "200": {
            "description": "Successful Response",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/PublicStatus"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          },
          "429": {
            "description": "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",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/ErrorBody"
                }
              }
            },
            "headers": {
              "X-Request-Id": {
                "$ref": "#/components/headers/X-Request-Id"
              }
            }
          }
        },
        "security": []
      }
    }
  },
  "components": {
    "schemas": {
      "AccessibilityCheckerData": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "final_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Final Url"
          },
          "status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "mode": {
            "type": "string",
            "enum": [
              "static",
              "contrast"
            ],
            "title": "Mode"
          },
          "disclaimer": {
            "type": "string",
            "title": "Disclaimer"
          },
          "truncated": {
            "type": "boolean",
            "title": "Truncated"
          },
          "counts": {
            "additionalProperties": {
              "type": "integer"
            },
            "type": "object",
            "title": "Counts"
          },
          "headings": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array",
            "title": "Headings"
          },
          "instances": {
            "additionalProperties": {
              "items": {
                "additionalProperties": {
                  "type": "string"
                },
                "type": "object"
              },
              "type": "array"
            },
            "type": "object",
            "title": "Instances"
          },
          "axe": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Axe"
          }
        },
        "type": "object",
        "required": [
          "url",
          "final_url",
          "status",
          "mode",
          "disclaimer",
          "truncated",
          "counts",
          "headings",
          "instances",
          "axe"
        ],
        "title": "AccessibilityCheckerData",
        "description": "Basic automated accessibility checks of a page; optionally colour contrast and axe-core rules in a browser."
      },
      "AccessibilityCheckerParams": {
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 2048,
            "minLength": 1,
            "title": "Url",
            "description": "A page URL or a domain; a domain means its home page.",
            "examples": [
              "example.com"
            ],
            "x-mono": true,
            "x-widget": "url"
          },
          "contrast": {
            "type": "boolean",
            "title": "Check colour contrast",
            "description": "Also load the page in a headless browser and run axe-core, which adds colour contrast and more rules. Costs 5 credits and runs as a job.",
            "default": false
          },
          "fresh": {
            "type": "boolean",
            "title": "Fresh",
            "description": "Skip the cache and ask the source again; costs the same.",
            "default": false
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "url"
        ],
        "title": "AccessibilityCheckerParams"
      },
      "AccessibilityCheckerResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/AccessibilityCheckerData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "AccessibilityCheckerResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "AccountInfo": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "email": {
            "type": "string",
            "title": "Email"
          },
          "plan": {
            "type": "string",
            "title": "Plan"
          },
          "status": {
            "type": "string",
            "enum": [
              "active",
              "suspended"
            ],
            "title": "Status"
          }
        },
        "type": "object",
        "required": [
          "id",
          "email",
          "plan",
          "status"
        ],
        "title": "AccountInfo"
      },
      "AccountResponse": {
        "properties": {
          "account": {
            "$ref": "#/components/schemas/AccountInfo"
          },
          "credits": {
            "$ref": "#/components/schemas/Credits"
          },
          "recent_usage": {
            "items": {
              "$ref": "#/components/schemas/UsageItem"
            },
            "type": "array",
            "title": "Recent Usage",
            "description": "Last 20 usage events, newest first"
          }
        },
        "type": "object",
        "required": [
          "account",
          "credits",
          "recent_usage"
        ],
        "title": "AccountResponse"
      },
      "AdsFile": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "present": {
            "type": "boolean",
            "title": "Present"
          },
          "records": {
            "type": "integer",
            "title": "Records"
          },
          "direct": {
            "type": "integer",
            "title": "Direct"
          },
          "reseller": {
            "type": "integer",
            "title": "Reseller"
          },
          "malformed_lines": {
            "items": {
              "type": "integer"
            },
            "type": "array",
            "title": "Malformed Lines"
          },
          "variables": {
            "additionalProperties": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "type": "object",
            "title": "Variables"
          }
        },
        "type": "object",
        "required": [
          "url",
          "present",
          "records",
          "direct",
          "reseller",
          "malformed_lines",
          "variables"
        ],
        "title": "AdsFile"
      },
      "AiCrawlerCheckerData": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "robots_url": {
            "type": "string",
            "title": "Robots Url"
          },
          "robots_status": {
            "type": "string",
            "enum": [
              "ok",
              "missing",
              "server_error",
              "unreachable"
            ],
            "title": "Robots Status"
          },
          "robots_http_status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Robots Http Status"
          },
          "sitemaps": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Sitemaps"
          },
          "invalid_lines": {
            "items": {
              "type": "integer"
            },
            "type": "array",
            "title": "Invalid Lines"
          },
          "crawlers": {
            "items": {
              "$ref": "#/components/schemas/CrawlerVerdict"
            },
            "type": "array",
            "title": "Crawlers"
          },
          "groups": {
            "additionalProperties": {
              "type": "string",
              "enum": [
                "allowed",
                "blocked",
                "mixed"
              ]
            },
            "type": "object",
            "title": "Groups"
          },
          "content_signals": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array",
            "title": "Content Signals"
          },
          "page_directives": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Page Directives"
          },
          "llms_txt": {
            "$ref": "#/components/schemas/LlmsTxt"
          },
          "catalog_checked": {
            "type": "string",
            "title": "Catalog Checked"
          }
        },
        "type": "object",
        "required": [
          "url",
          "robots_url",
          "robots_status",
          "robots_http_status",
          "sitemaps",
          "invalid_lines",
          "crawlers",
          "groups",
          "content_signals",
          "page_directives",
          "llms_txt",
          "catalog_checked"
        ],
        "title": "AiCrawlerCheckerData",
        "description": "Which search, AI training and AI assistant crawlers robots.txt allows for a page, page directives and llms.txt."
      },
      "AiCrawlerCheckerResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/AiCrawlerCheckerData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "AiCrawlerCheckerResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "AlignedRow": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "finding_id": {
            "type": "string",
            "title": "Finding Id"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "per_domain": {
            "items": {
              "anyOf": [
                {
                  "$ref": "#/components/schemas/Severity"
                },
                {
                  "type": "null"
                }
              ]
            },
            "type": "array",
            "title": "Per Domain"
          },
          "differs": {
            "type": "boolean",
            "title": "Differs"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "finding_id",
          "title",
          "per_domain",
          "differs"
        ],
        "title": "AlignedRow"
      },
      "AlignmentData": {
        "properties": {
          "from_domains": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "From Domains"
          },
          "return_path_domain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Return Path Domain"
          },
          "spf_aligned": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Spf Aligned"
          },
          "dkim_domains_claimed": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Dkim Domains Claimed"
          },
          "dkim_aligned_pass": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Dkim Aligned Pass"
          }
        },
        "type": "object",
        "required": [
          "from_domains",
          "return_path_domain",
          "spf_aligned",
          "dkim_domains_claimed",
          "dkim_aligned_pass"
        ],
        "title": "AlignmentData"
      },
      "AllocationData": {
        "properties": {
          "registry": {
            "$ref": "#/components/schemas/Rir"
          },
          "country": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Country"
          },
          "date": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Date"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "block": {
            "type": "string",
            "title": "Block"
          }
        },
        "type": "object",
        "required": [
          "registry",
          "country",
          "date",
          "status",
          "block"
        ],
        "title": "AllocationData"
      },
      "AsnAddressRow": {
        "properties": {
          "address": {
            "type": "string",
            "title": "Address"
          },
          "route": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RouteData"
              },
              {
                "type": "null"
              }
            ]
          },
          "allocation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AllocationData"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "address",
          "route",
          "allocation"
        ],
        "title": "AsnAddressRow"
      },
      "AsnData": {
        "properties": {
          "number": {
            "type": "integer",
            "title": "Number"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "country": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Country"
          },
          "reserved": {
            "type": "boolean",
            "title": "Reserved"
          }
        },
        "type": "object",
        "required": [
          "number",
          "name",
          "description",
          "country",
          "reserved"
        ],
        "title": "AsnData"
      },
      "AsnLookupData": {
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "ip",
              "domain",
              "asn"
            ],
            "title": "Kind"
          },
          "query": {
            "type": "string",
            "title": "Query"
          },
          "addresses": {
            "items": {
              "$ref": "#/components/schemas/AsnAddressRow"
            },
            "type": "array",
            "title": "Addresses"
          },
          "asn": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AsnData"
              },
              {
                "type": "null"
              }
            ]
          },
          "asn_allocation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AllocationData"
              },
              {
                "type": "null"
              }
            ]
          },
          "prefixes": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Prefixes"
          },
          "prefixes_v4": {
            "type": "integer",
            "title": "Prefixes V4"
          },
          "prefixes_v6": {
            "type": "integer",
            "title": "Prefixes V6"
          },
          "ipv4_addresses": {
            "type": "integer",
            "title": "Ipv4 Addresses"
          },
          "truncated": {
            "type": "boolean",
            "title": "Truncated"
          },
          "table": {
            "$ref": "#/components/schemas/TableData"
          }
        },
        "type": "object",
        "required": [
          "kind",
          "query",
          "addresses",
          "asn",
          "asn_allocation",
          "prefixes",
          "prefixes_v4",
          "prefixes_v6",
          "ipv4_addresses",
          "truncated",
          "table"
        ],
        "title": "AsnLookupData",
        "description": "The announced prefixes, origin AS, holder and allocation for an IP address, a domain's addresses or an AS number."
      },
      "AsnLookupResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/AsnLookupData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "AsnLookupResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "AssetCache": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Type"
          },
          "cache_control": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cache Control"
          },
          "etag": {
            "type": "boolean",
            "title": "Etag"
          },
          "last_modified": {
            "type": "boolean",
            "title": "Last Modified"
          },
          "encoding": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Encoding"
          },
          "bytes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Bytes"
          },
          "wire_bytes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Wire Bytes"
          }
        },
        "type": "object",
        "required": [
          "url",
          "type",
          "cache_control",
          "etag",
          "last_modified",
          "encoding",
          "bytes",
          "wire_bytes"
        ],
        "title": "AssetCache"
      },
      "AttemptData": {
        "properties": {
          "method": {
            "type": "string",
            "enum": [
              "rdap",
              "rdap-registrar",
              "whois",
              "whois-referral"
            ],
            "title": "Method"
          },
          "server": {
            "type": "string",
            "title": "Server"
          },
          "outcome": {
            "type": "string",
            "title": "Outcome"
          },
          "http_status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Http Status"
          },
          "elapsed_ms": {
            "type": "integer",
            "title": "Elapsed Ms"
          }
        },
        "type": "object",
        "required": [
          "method",
          "server",
          "outcome",
          "elapsed_ms"
        ],
        "title": "AttemptData"
      },
      "AuthResultsData": {
        "properties": {
          "authserv_id": {
            "type": "string",
            "title": "Authserv Id"
          },
          "trusted": {
            "type": "boolean",
            "title": "Trusted"
          },
          "spf": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MethodData"
              },
              {
                "type": "null"
              }
            ]
          },
          "dkim": {
            "items": {
              "$ref": "#/components/schemas/MethodData"
            },
            "type": "array",
            "title": "Dkim"
          },
          "dmarc": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MethodData"
              },
              {
                "type": "null"
              }
            ]
          },
          "arc": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MethodData"
              },
              {
                "type": "null"
              }
            ]
          },
          "other": {
            "items": {
              "$ref": "#/components/schemas/MethodData"
            },
            "type": "array",
            "title": "Other"
          }
        },
        "type": "object",
        "required": [
          "authserv_id",
          "trusted",
          "spf",
          "dkim",
          "dmarc",
          "arc",
          "other"
        ],
        "title": "AuthResultsData"
      },
      "BatchResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "status": {
            "type": "string",
            "enum": [
              "ok",
              "partial",
              "error"
            ],
            "title": "Status"
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used"
          },
          "credits_remaining": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Credits Remaining"
          },
          "items": {
            "items": {
              "$ref": "#/components/schemas/ToolResult"
            },
            "type": "array",
            "title": "Items"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "status",
          "summary",
          "credits_used",
          "credits_remaining",
          "items"
        ],
        "title": "BatchResponse",
        "description": "200 body of a per-name tool call with up to `sync_max` names: one charge for the batch."
      },
      "BimiCertificateData": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "fetched": {
            "type": "boolean",
            "title": "Fetched"
          },
          "kind": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "vmc",
                  "cmc",
                  "unknown"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Kind"
          },
          "subject_org": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Subject Org"
          },
          "issuer_org": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Issuer Org"
          },
          "not_before": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Not Before"
          },
          "not_after": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Not After"
          },
          "days_left": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Days Left"
          },
          "domains": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Domains"
          },
          "covers_domain": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Covers Domain"
          },
          "eku_ok": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Eku Ok"
          },
          "mark_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Mark Type"
          },
          "chain_verified": {
            "type": "null",
            "title": "Chain Verified"
          }
        },
        "type": "object",
        "required": [
          "url",
          "fetched",
          "kind",
          "subject_org",
          "issuer_org",
          "not_before",
          "not_after",
          "days_left",
          "domains",
          "covers_domain",
          "eku_ok",
          "mark_type"
        ],
        "title": "BimiCertificateData"
      },
      "BimiData": {
        "properties": {
          "verdict": {
            "type": "string",
            "enum": [
              "ready",
              "declined",
              "missing",
              "broken",
              "not_shown",
              "unknown"
            ],
            "title": "Verdict"
          },
          "present": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Present"
          },
          "record": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Record"
          },
          "logo": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BimiLogoData"
              },
              {
                "type": "null"
              }
            ]
          },
          "certificate": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BimiCertificateData"
              },
              {
                "type": "null"
              }
            ]
          },
          "dmarc": {
            "$ref": "#/components/schemas/BimiDmarcData"
          }
        },
        "type": "object",
        "required": [
          "verdict",
          "present",
          "record",
          "logo",
          "certificate",
          "dmarc"
        ],
        "title": "BimiData"
      },
      "BimiDmarcData": {
        "properties": {
          "policy": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Policy"
          },
          "pct": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pct"
          },
          "testing": {
            "type": "boolean",
            "title": "Testing"
          },
          "inherited": {
            "type": "boolean",
            "title": "Inherited"
          },
          "enforced_for_all": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Enforced For All"
          }
        },
        "type": "object",
        "required": [
          "policy",
          "pct",
          "testing",
          "inherited",
          "enforced_for_all"
        ],
        "title": "BimiDmarcData"
      },
      "BimiLogoData": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "fetched": {
            "type": "boolean",
            "title": "Fetched"
          },
          "status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "content_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Content Type"
          },
          "size_bytes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Size Bytes"
          },
          "square": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Square"
          },
          "profile_ok": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Profile Ok"
          },
          "title_present": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title Present"
          },
          "problems": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Problems"
          },
          "sha256": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sha256"
          }
        },
        "type": "object",
        "required": [
          "url",
          "fetched",
          "status",
          "content_type",
          "size_bytes",
          "square",
          "profile_ok",
          "title_present",
          "problems",
          "sha256"
        ],
        "title": "BimiLogoData"
      },
      "BrokenLinkCheckerParams": {
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 2048,
            "minLength": 1,
            "title": "Url",
            "description": "A page URL or a domain; a domain means its home page.",
            "examples": [
              "example.com"
            ],
            "x-mono": true,
            "x-widget": "url"
          },
          "max_pages": {
            "type": "integer",
            "maximum": 500,
            "minimum": 1,
            "title": "Max Pages",
            "description": "Pages to crawl on this site; costs 5 credits per 50.",
            "default": 50
          },
          "external": {
            "type": "boolean",
            "title": "External",
            "description": "Also check links to other sites.",
            "default": true
          },
          "fresh": {
            "type": "boolean",
            "title": "Fresh",
            "description": "Skip the cache and ask the source again; costs the same.",
            "default": false
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "url"
        ],
        "title": "BrokenLinkCheckerParams"
      },
      "BulkDryRunResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "rows": {
            "type": "integer",
            "title": "Rows",
            "description": "Rows sent"
          },
          "unique": {
            "type": "integer",
            "title": "Unique",
            "description": "Valid rows that would run after removing duplicates"
          },
          "duplicates_removed": {
            "type": "integer",
            "title": "Duplicates Removed"
          },
          "invalid": {
            "type": "integer",
            "title": "Invalid",
            "description": "Rows with an error"
          },
          "errors": {
            "items": {
              "$ref": "#/components/schemas/BulkRowError"
            },
            "type": "array",
            "title": "Errors",
            "description": "The first 100 row errors"
          },
          "columns": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Columns",
            "description": "The input each column was read as"
          },
          "preview": {
            "items": {
              "$ref": "#/components/schemas/BulkPreviewRow"
            },
            "type": "array",
            "title": "Preview",
            "description": "The first 5 valid rows"
          },
          "limit": {
            "type": "integer",
            "title": "Limit",
            "description": "The most rows one bulk check with this tool may have"
          },
          "credits": {
            "type": "integer",
            "title": "Credits",
            "description": "Credits the job would hold when it starts"
          },
          "balance": {
            "type": "integer",
            "title": "Balance",
            "description": "Your balance now"
          },
          "estimated_max_s": {
            "type": "integer",
            "title": "Estimated Max S",
            "description": "The longest the job could take, if every row is as slow as it can be"
          },
          "unverified": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Unverified",
            "description": "Domains still needing their TXT ownership record (at most 20)"
          },
          "records": {
            "items": {
              "$ref": "#/components/schemas/VerificationRecordView"
            },
            "type": "array",
            "title": "Records",
            "description": "The TXT record to publish for each of them"
          },
          "verification_checked": {
            "type": "boolean",
            "title": "Verification Checked",
            "description": "True when the records were looked up (`check_ownership`)"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "rows",
          "unique",
          "duplicates_removed",
          "invalid",
          "errors",
          "columns",
          "preview",
          "limit",
          "credits",
          "balance",
          "estimated_max_s",
          "unverified",
          "verification_checked"
        ],
        "title": "BulkDryRunResponse"
      },
      "BulkPreviewRow": {
        "properties": {
          "row": {
            "type": "integer",
            "title": "Row"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "options": {
            "additionalProperties": true,
            "type": "object",
            "title": "Options"
          }
        },
        "type": "object",
        "required": [
          "row",
          "target",
          "options"
        ],
        "title": "BulkPreviewRow"
      },
      "BulkRowError": {
        "properties": {
          "row": {
            "type": "integer",
            "title": "Row",
            "description": "CSV line (1-based) or position in the list"
          },
          "column": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Column"
          },
          "message": {
            "type": "string",
            "title": "Message"
          }
        },
        "type": "object",
        "required": [
          "row",
          "column",
          "message"
        ],
        "title": "BulkRowError"
      },
      "CaaBuild": {
        "properties": {
          "records": {
            "items": {
              "$ref": "#/components/schemas/CaaRecordData"
            },
            "type": "array",
            "title": "Records"
          },
          "zone_lines": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Zone Lines"
          }
        },
        "type": "object",
        "required": [
          "records",
          "zone_lines"
        ],
        "title": "CaaBuild"
      },
      "CaaGeneratorData": {
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "spf",
              "dmarc",
              "caa"
            ],
            "title": "Kind"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "type": {
            "type": "string",
            "enum": [
              "TXT",
              "CAA"
            ],
            "title": "Type"
          },
          "value": {
            "type": "string",
            "title": "Value"
          },
          "strings": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Strings"
          },
          "length": {
            "type": "integer",
            "title": "Length"
          },
          "zone_line": {
            "type": "string",
            "title": "Zone Line"
          },
          "mode": {
            "type": "string",
            "enum": [
              "build",
              "validate"
            ],
            "title": "Mode"
          },
          "spf": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SpfBuild"
              },
              {
                "type": "null"
              }
            ]
          },
          "dmarc": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DmarcBuild"
              },
              {
                "type": "null"
              }
            ]
          },
          "caa": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaaBuild"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "kind",
          "name",
          "type",
          "value",
          "strings",
          "length",
          "zone_line",
          "mode"
        ],
        "title": "CaaGeneratorData",
        "description": "CAA records built from the certificate authorities you choose, as zone file lines."
      },
      "CaaGeneratorParams": {
        "properties": {
          "domain": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ],
            "title": "Domain",
            "description": "Your domain; names the records.",
            "examples": [
              "example.com"
            ]
          },
          "issue": {
            "items": {
              "type": "string",
              "maxLength": 253
            },
            "type": "array",
            "maxItems": 10,
            "title": "Issue",
            "description": "Certificate authorities allowed to issue, by id or CAA identifier; an empty list means no authority may issue.",
            "x-widget": "lines"
          },
          "wildcard": {
            "type": "string",
            "enum": [
              "same",
              "none",
              "custom"
            ],
            "title": "Wildcard",
            "description": "Who may issue wildcard certificates.",
            "default": "same"
          },
          "issuewild": {
            "anyOf": [
              {
                "items": {
                  "type": "string",
                  "maxLength": 253
                },
                "type": "array",
                "maxItems": 10
              },
              {
                "type": "null"
              }
            ],
            "title": "Issuewild",
            "description": "Authorities allowed to issue wildcard certificates, when wildcard is custom.",
            "x-advanced": true,
            "x-widget": "lines"
          },
          "validation_methods": {
            "anyOf": [
              {
                "items": {
                  "type": "string",
                  "enum": [
                    "dns-01",
                    "http-01",
                    "tls-alpn-01"
                  ]
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "uniqueItems": true,
            "title": "Validation Methods",
            "description": "Allowed validation methods, for every authority listed.",
            "x-advanced": true,
            "x-widget": "checkboxes"
          },
          "account_uri": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 512
              },
              {
                "type": "null"
              }
            ],
            "title": "Account Uri",
            "description": "Your ACME account URI; only with exactly one authority.",
            "x-advanced": true
          },
          "iodef": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 512
              },
              {
                "type": "null"
              }
            ],
            "title": "Iodef",
            "description": "Where authorities report refused requests (mailto or https).",
            "x-advanced": true
          },
          "current_issuer": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 253
              },
              {
                "type": "null"
              }
            ],
            "title": "Current Issuer",
            "description": "The authority that issued your current certificate, to warn before locking it out.",
            "x-advanced": true
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "issue"
        ],
        "title": "CaaGeneratorParams"
      },
      "CaaGeneratorResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/CaaGeneratorData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "CaaGeneratorResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "CaaRecordData": {
        "properties": {
          "flags": {
            "type": "integer",
            "title": "Flags"
          },
          "tag": {
            "type": "string",
            "title": "Tag"
          },
          "value": {
            "type": "string",
            "title": "Value"
          },
          "presentation": {
            "type": "string",
            "title": "Presentation"
          }
        },
        "type": "object",
        "required": [
          "flags",
          "tag",
          "value",
          "presentation"
        ],
        "title": "CaaRecordData"
      },
      "CalendarFeedCreated": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url",
            "description": "The feed URL. Shown once: we keep only a hash of it. Whoever has it, including the calendar app's provider, sees the monitored domains and their dates."
          }
        },
        "type": "object",
        "required": [
          "url"
        ],
        "title": "CalendarFeedCreated"
      },
      "CalendarFeedState": {
        "properties": {
          "active": {
            "type": "boolean",
            "title": "Active",
            "description": "Whether the account has a feed URL that works"
          },
          "created_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created At",
            "description": "When the current URL was made"
          },
          "last_fetched_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Fetched At",
            "description": "When a calendar app last fetched it (updated at most hourly)"
          },
          "domains": {
            "type": "integer",
            "title": "Domains",
            "description": "Domain-expiry monitors the calendar lists"
          }
        },
        "type": "object",
        "required": [
          "active",
          "created_at",
          "last_fetched_at",
          "domains"
        ],
        "title": "CalendarFeedState"
      },
      "CallSource": {
        "properties": {
          "kind": {
            "type": "string",
            "const": "call",
            "title": "Kind"
          },
          "request_id": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Request Id",
            "description": "The X-Request-Id of the call whose result to export (kept 24 hours)"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "kind",
          "request_id"
        ],
        "title": "CallSource"
      },
      "CertDetails": {
        "properties": {
          "kind": {
            "type": "string",
            "const": "certificate",
            "title": "Kind",
            "default": "certificate"
          },
          "index": {
            "type": "integer",
            "title": "Index",
            "default": 0
          },
          "subject": {
            "type": "string",
            "title": "Subject"
          },
          "issuer": {
            "type": "string",
            "title": "Issuer"
          },
          "common_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Common Name"
          },
          "serial_hex": {
            "type": "string",
            "title": "Serial Hex"
          },
          "not_before": {
            "type": "string",
            "title": "Not Before"
          },
          "not_after": {
            "type": "string",
            "title": "Not After"
          },
          "days_left": {
            "type": "integer",
            "title": "Days Left"
          },
          "validity_days": {
            "type": "integer",
            "title": "Validity Days"
          },
          "names": {
            "$ref": "#/components/schemas/Names"
          },
          "key": {
            "$ref": "#/components/schemas/KeyDetails"
          },
          "signature_algorithm": {
            "type": "string",
            "title": "Signature Algorithm"
          },
          "signature_hash": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Signature Hash"
          },
          "key_usage": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Key Usage"
          },
          "extended_key_usage": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Extended Key Usage"
          },
          "ca": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ca"
          },
          "path_length": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Path Length"
          },
          "self_signed": {
            "type": "boolean",
            "title": "Self Signed"
          },
          "ski": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ski"
          },
          "aki": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Aki"
          },
          "ocsp": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Ocsp"
          },
          "ca_issuers": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Ca Issuers"
          },
          "crl": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Crl"
          },
          "policies": {
            "$ref": "#/components/schemas/Policies"
          },
          "scts": {
            "items": {
              "$ref": "#/components/schemas/Sct"
            },
            "type": "array",
            "title": "Scts"
          },
          "sha256": {
            "type": "string",
            "title": "Sha256"
          },
          "sha1": {
            "type": "string",
            "title": "Sha1"
          },
          "version": {
            "type": "integer",
            "title": "Version"
          }
        },
        "type": "object",
        "required": [
          "subject",
          "issuer",
          "common_name",
          "serial_hex",
          "not_before",
          "not_after",
          "days_left",
          "validity_days",
          "names",
          "key",
          "signature_algorithm",
          "signature_hash",
          "key_usage",
          "extended_key_usage",
          "ca",
          "path_length",
          "self_signed",
          "ski",
          "aki",
          "ocsp",
          "ca_issuers",
          "crl",
          "policies",
          "scts",
          "sha256",
          "sha1",
          "version"
        ],
        "title": "CertDetails"
      },
      "CertProblem": {
        "type": "string",
        "enum": [
          "expired",
          "not_yet_valid",
          "hostname",
          "self_signed",
          "untrusted",
          "handshake"
        ]
      },
      "Certainty": {
        "type": "string",
        "enum": [
          "confirmed",
          "likely"
        ]
      },
      "CertificateDecoderData": {
        "properties": {
          "items": {
            "items": {
              "oneOf": [
                {
                  "$ref": "#/components/schemas/CertDetails"
                },
                {
                  "$ref": "#/components/schemas/CsrDetails"
                }
              ],
              "discriminator": {
                "propertyName": "kind",
                "mapping": {
                  "certificate": "#/components/schemas/CertDetails",
                  "csr": "#/components/schemas/CsrDetails"
                }
              }
            },
            "type": "array",
            "title": "Items"
          },
          "chain": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ChainData"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "items",
          "chain"
        ],
        "title": "CertificateDecoderData",
        "description": "The decoded fields of pasted certificates and CSRs, and how a bundle chains; nothing is stored."
      },
      "CertificateDecoderParams": {
        "properties": {
          "pem": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 262144
              },
              {
                "type": "null"
              }
            ],
            "title": "Certificate or CSR",
            "description": "One or more PEM blocks, or base64 DER. Processed in memory and never stored.",
            "x-mono": true,
            "x-widget": "textarea"
          },
          "file_base64": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 350000
              },
              {
                "type": "null"
              }
            ],
            "title": "File",
            "description": "A .pem, .crt, .cer, .der, .csr or .p7b file, base64-encoded. Send either this or the pasted text.",
            "x-accept": ".pem,.crt,.cer,.der,.csr,.p7b",
            "x-widget": "file"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "CertificateDecoderParams"
      },
      "CertificateDecoderResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/CertificateDecoderData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "CertificateDecoderResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "CertificateInfo": {
        "properties": {
          "subject": {
            "type": "string",
            "title": "Subject"
          },
          "common_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Common Name"
          },
          "names": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Names"
          },
          "issuer": {
            "type": "string",
            "title": "Issuer"
          },
          "issuer_org": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Issuer Org"
          },
          "caa_identifiers": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Caa Identifiers",
            "description": "CAA identifiers of the issuing authority (registry/providers.yaml)."
          },
          "serial": {
            "type": "string",
            "title": "Serial"
          },
          "not_before": {
            "type": "string",
            "title": "Not Before"
          },
          "not_after": {
            "type": "string",
            "title": "Not After"
          },
          "days_left": {
            "type": "integer",
            "title": "Days Left"
          },
          "key": {
            "$ref": "#/components/schemas/KeyInfo"
          },
          "signature_algorithm": {
            "type": "string",
            "title": "Signature Algorithm"
          },
          "sha256": {
            "type": "string",
            "title": "Sha256"
          },
          "scts": {
            "type": "integer",
            "title": "Scts"
          },
          "ocsp_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ocsp Url"
          },
          "ca_issuers_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ca Issuers Url"
          }
        },
        "type": "object",
        "required": [
          "subject",
          "common_name",
          "names",
          "issuer",
          "issuer_org",
          "caa_identifiers",
          "serial",
          "not_before",
          "not_after",
          "days_left",
          "key",
          "signature_algorithm",
          "sha256",
          "scts",
          "ocsp_url",
          "ca_issuers_url"
        ],
        "title": "CertificateInfo"
      },
      "ChainCert": {
        "properties": {
          "subject": {
            "type": "string",
            "title": "Subject"
          },
          "issuer": {
            "type": "string",
            "title": "Issuer"
          },
          "not_after": {
            "type": "string",
            "title": "Not After"
          },
          "sha256": {
            "type": "string",
            "title": "Sha256"
          },
          "is_ca": {
            "type": "boolean",
            "title": "Is Ca"
          },
          "self_signed": {
            "type": "boolean",
            "title": "Self Signed"
          },
          "pem": {
            "type": "string",
            "title": "Pem"
          }
        },
        "type": "object",
        "required": [
          "subject",
          "issuer",
          "not_after",
          "sha256",
          "is_ca",
          "self_signed",
          "pem"
        ],
        "title": "ChainCert"
      },
      "ChainData": {
        "properties": {
          "order": {
            "items": {
              "type": "integer"
            },
            "type": "array",
            "title": "Order"
          },
          "links": {
            "items": {
              "$ref": "#/components/schemas/ChainLinkData"
            },
            "type": "array",
            "title": "Links"
          },
          "ends_at": {
            "type": "string",
            "enum": [
              "trusted_root",
              "self_signed",
              "intermediate"
            ],
            "title": "Ends At"
          },
          "reordered": {
            "type": "boolean",
            "title": "Reordered"
          }
        },
        "type": "object",
        "required": [
          "order",
          "links",
          "ends_at",
          "reordered"
        ],
        "title": "ChainData"
      },
      "ChainLink": {
        "properties": {
          "zone": {
            "type": "string",
            "title": "Zone"
          },
          "signed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Signed",
            "description": "A DS record for this zone exists at its parent"
          },
          "secure": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Secure",
            "description": "The resolver validated that DS answer"
          }
        },
        "type": "object",
        "required": [
          "zone",
          "signed",
          "secure"
        ],
        "title": "ChainLink"
      },
      "ChainLinkData": {
        "properties": {
          "child": {
            "type": "integer",
            "title": "Child"
          },
          "parent": {
            "type": "integer",
            "title": "Parent"
          },
          "signed": {
            "type": "boolean",
            "title": "Signed"
          }
        },
        "type": "object",
        "required": [
          "child",
          "parent",
          "signed"
        ],
        "title": "ChainLinkData"
      },
      "Channel": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "type": {
            "type": "string",
            "title": "Type"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "hint": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Hint",
            "description": "A shortened form of the URL; never the full URL"
          },
          "recipients": {
            "items": {
              "$ref": "#/components/schemas/RecipientView"
            },
            "type": "array",
            "title": "Recipients"
          },
          "digest": {
            "type": "boolean",
            "title": "Digest"
          },
          "digest_hour": {
            "type": "integer",
            "title": "Digest Hour"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "paused_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Paused Reason"
          },
          "limited": {
            "type": "boolean",
            "title": "Limited"
          },
          "jobs_only": {
            "type": "boolean",
            "title": "Jobs Only"
          },
          "is_default": {
            "type": "boolean",
            "title": "Is Default"
          },
          "verified_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Verified At"
          },
          "failure_count": {
            "type": "integer",
            "title": "Failure Count"
          },
          "last_success_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Success At"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "type",
          "name",
          "hint",
          "recipients",
          "digest",
          "digest_hour",
          "status",
          "paused_reason",
          "limited",
          "jobs_only",
          "is_default",
          "verified_at",
          "failure_count",
          "last_success_at",
          "created_at"
        ],
        "title": "Channel"
      },
      "ChannelCreated": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "type": {
            "type": "string",
            "title": "Type"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "hint": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Hint",
            "description": "A shortened form of the URL; never the full URL"
          },
          "recipients": {
            "items": {
              "$ref": "#/components/schemas/RecipientView"
            },
            "type": "array",
            "title": "Recipients"
          },
          "digest": {
            "type": "boolean",
            "title": "Digest"
          },
          "digest_hour": {
            "type": "integer",
            "title": "Digest Hour"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "paused_reason": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Paused Reason"
          },
          "limited": {
            "type": "boolean",
            "title": "Limited"
          },
          "jobs_only": {
            "type": "boolean",
            "title": "Jobs Only"
          },
          "is_default": {
            "type": "boolean",
            "title": "Is Default"
          },
          "verified_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Verified At"
          },
          "failure_count": {
            "type": "integer",
            "title": "Failure Count"
          },
          "last_success_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Success At"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          },
          "signing_secret": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Signing Secret",
            "description": "Webhooks only, shown once: verify our signatures with it"
          }
        },
        "type": "object",
        "required": [
          "id",
          "type",
          "name",
          "hint",
          "recipients",
          "digest",
          "digest_hour",
          "status",
          "paused_reason",
          "limited",
          "jobs_only",
          "is_default",
          "verified_at",
          "failure_count",
          "last_success_at",
          "created_at"
        ],
        "title": "ChannelCreated"
      },
      "ChannelList": {
        "properties": {
          "channels": {
            "items": {
              "$ref": "#/components/schemas/Channel"
            },
            "type": "array",
            "title": "Channels"
          },
          "alert_delivery": {
            "type": "boolean",
            "title": "Alert Delivery",
            "description": "False while alert delivery is off on this server"
          },
          "bulk_unlocked": {
            "type": "boolean",
            "title": "Bulk Unlocked",
            "description": "True when the account may add a bulk completion (jobs_only) webhook",
            "default": false
          }
        },
        "type": "object",
        "required": [
          "channels",
          "alert_delivery"
        ],
        "title": "ChannelList"
      },
      "CheckAccepted": {
        "properties": {
          "accepted": {
            "type": "boolean",
            "title": "Accepted",
            "default": true
          },
          "next_run_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Run At"
          }
        },
        "type": "object",
        "required": [
          "next_run_at"
        ],
        "title": "CheckAccepted"
      },
      "CompareCell": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "domain": {
            "type": "string",
            "title": "Domain"
          },
          "envelope": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ResultEnvelope"
              },
              {
                "type": "null"
              }
            ],
            "description": "The tool's result; null for an error cell"
          },
          "error": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ErrorBody"
              },
              {
                "type": "null"
              }
            ],
            "description": "Why this cell has no result (not charged)"
          },
          "credits": {
            "type": "integer",
            "title": "Credits",
            "description": "Credits this cell cost (0 for an error)"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "domain",
          "envelope",
          "error",
          "credits",
          "cached"
        ],
        "title": "CompareCell"
      },
      "CompareRequest": {
        "properties": {
          "domains": {
            "items": {
              "type": "string",
              "maxLength": 253
            },
            "type": "array",
            "maxItems": 4,
            "minItems": 2,
            "title": "Domains",
            "description": "2 to 4 domains to compare, such as example.com (each once)",
            "examples": [
              [
                "example.com",
                "example.net"
              ]
            ]
          },
          "tools": {
            "items": {
              "type": "string",
              "maxLength": 64
            },
            "type": "array",
            "maxItems": 4,
            "minItems": 1,
            "title": "Tools",
            "description": "1 to 4 tool ids to run on every domain, such as ssl-checker",
            "examples": [
              [
                "ssl-checker",
                "email-checker"
              ]
            ]
          },
          "fresh": {
            "type": "boolean",
            "title": "Fresh",
            "description": "Skip the cache for every cell and ask again. Costs the same as cached answers.",
            "default": false
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "domains",
          "tools"
        ],
        "title": "CompareRequest"
      },
      "CompareResponse": {
        "properties": {
          "domains": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Domains",
            "description": "The domains as checked (ASCII form), column order"
          },
          "tools": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Tools"
          },
          "status": {
            "type": "string",
            "enum": [
              "ok",
              "partial",
              "error"
            ],
            "title": "Status"
          },
          "cells": {
            "items": {
              "$ref": "#/components/schemas/CompareCell"
            },
            "type": "array",
            "title": "Cells",
            "description": "One cell per tool and domain, tool order first"
          },
          "rows": {
            "items": {
              "$ref": "#/components/schemas/AlignedRow"
            },
            "type": "array",
            "title": "Rows",
            "description": "Findings lined up across the domains; differing rows first"
          },
          "scores": {
            "items": {
              "$ref": "#/components/schemas/ToolScores"
            },
            "type": "array",
            "title": "Scores",
            "description": "Each tool's score per domain (graded tools)"
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used"
          },
          "credits_remaining": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Credits Remaining"
          }
        },
        "type": "object",
        "required": [
          "domains",
          "tools",
          "status",
          "cells",
          "rows",
          "scores",
          "summary",
          "credits_used",
          "credits_remaining"
        ],
        "title": "CompareResponse"
      },
      "CompareSource": {
        "properties": {
          "kind": {
            "type": "string",
            "const": "compare",
            "title": "Kind"
          },
          "request_id": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "title": "Request Id",
            "description": "The X-Request-Id of the compare call (kept 24 hours)"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "kind",
          "request_id"
        ],
        "title": "CompareSource"
      },
      "CompareStreamStart": {
        "properties": {
          "stream_id": {
            "type": "string",
            "title": "Stream Id",
            "description": "Opaque id of the run's event stream"
          },
          "events_url": {
            "type": "string",
            "title": "Events Url",
            "description": "Open this for the events (GET, text/event-stream)"
          },
          "request_id": {
            "type": "string",
            "title": "Request Id",
            "description": "This call's request id, the ledger reference"
          }
        },
        "type": "object",
        "required": [
          "stream_id",
          "events_url",
          "request_id"
        ],
        "title": "CompareStreamStart"
      },
      "ComponentId": {
        "type": "string",
        "enum": [
          "web",
          "api",
          "mcp",
          "jobs",
          "monitoring",
          "browser",
          "dns",
          "registration",
          "email",
          "payments"
        ]
      },
      "ComponentState": {
        "type": "string",
        "enum": [
          "operational",
          "degraded",
          "outage",
          "maintenance",
          "unknown"
        ]
      },
      "CookieInfo": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "domain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Domain"
          },
          "path": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Path"
          },
          "secure": {
            "type": "boolean",
            "title": "Secure"
          },
          "http_only": {
            "type": "boolean",
            "title": "Http Only"
          },
          "same_site": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Same Site"
          },
          "session": {
            "type": "boolean",
            "title": "Session"
          },
          "prefix_ok": {
            "type": "boolean",
            "title": "Prefix Ok"
          },
          "over_https": {
            "type": "boolean",
            "title": "Over Https"
          }
        },
        "type": "object",
        "required": [
          "name",
          "domain",
          "path",
          "secure",
          "http_only",
          "same_site",
          "session",
          "prefix_ok",
          "over_https"
        ],
        "title": "CookieInfo"
      },
      "CookieScannerParams": {
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 2048,
            "minLength": 1,
            "title": "Url",
            "description": "A page URL or a domain; a domain means its home page.",
            "examples": [
              "example.com"
            ],
            "x-mono": true,
            "x-widget": "url"
          },
          "fresh": {
            "type": "boolean",
            "title": "Fresh",
            "description": "Skip the cache and ask the source again; costs the same.",
            "default": false
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "url"
        ],
        "title": "CookieScannerParams"
      },
      "CrawlerVerdict": {
        "properties": {
          "token": {
            "type": "string",
            "title": "Token"
          },
          "vendor": {
            "type": "string",
            "title": "Vendor"
          },
          "purpose": {
            "type": "string",
            "enum": [
              "search",
              "training",
              "retrieval"
            ],
            "title": "Purpose"
          },
          "user_triggered": {
            "type": "boolean",
            "title": "User Triggered"
          },
          "allowed": {
            "type": "boolean",
            "title": "Allowed"
          },
          "reason": {
            "type": "string",
            "enum": [
              "rule",
              "no_matching_rule",
              "no_group",
              "missing",
              "server_error",
              "unreachable"
            ],
            "title": "Reason"
          },
          "rule": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Rule"
          },
          "rule_line": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Rule Line"
          },
          "group_agents": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Group Agents"
          }
        },
        "type": "object",
        "required": [
          "token",
          "vendor",
          "purpose",
          "user_triggered",
          "allowed",
          "reason",
          "rule",
          "rule_line",
          "group_agents"
        ],
        "title": "CrawlerVerdict"
      },
      "CreateChannel": {
        "properties": {
          "type": {
            "type": "string",
            "enum": [
              "email",
              "webhook",
              "slack"
            ],
            "title": "Type"
          },
          "name": {
            "type": "string",
            "maxLength": 60,
            "minLength": 1,
            "title": "Name"
          },
          "url": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ],
            "title": "Url"
          },
          "recipients": {
            "anyOf": [
              {
                "items": {
                  "type": "string",
                  "format": "uuid"
                },
                "type": "array",
                "maxItems": 50
              },
              {
                "type": "null"
              }
            ],
            "title": "Recipients"
          },
          "digest": {
            "type": "boolean",
            "title": "Digest",
            "default": false
          },
          "digest_hour": {
            "type": "integer",
            "maximum": 23,
            "minimum": 0,
            "title": "Digest Hour",
            "default": 8
          },
          "jobs_only": {
            "type": "boolean",
            "title": "Jobs Only",
            "default": false
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "type",
          "name"
        ],
        "title": "CreateChannel"
      },
      "CreateMonitor": {
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "domain-expiry",
              "ssl",
              "dns",
              "uptime",
              "page-change",
              "score-drop",
              "lookalikes"
            ],
            "title": "Kind",
            "description": "What to watch"
          },
          "target": {
            "type": "string",
            "maxLength": 2048,
            "minLength": 1,
            "title": "Target",
            "description": "A domain (domain-expiry, ssl, dns, lookalikes) or a URL (uptime, page-change, score-drop)"
          },
          "interval": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Interval",
            "description": "Seconds between checks; default: the kind's longest interval your plan allows"
          },
          "options": {
            "additionalProperties": true,
            "type": "object",
            "title": "Options",
            "description": "Options for this kind (see the docs)"
          },
          "rules": {
            "$ref": "#/components/schemas/Rules"
          },
          "channel_ids": {
            "anyOf": [
              {
                "items": {
                  "type": "string",
                  "format": "uuid"
                },
                "type": "array",
                "maxItems": 10
              },
              {
                "type": "null"
              }
            ],
            "title": "Channel Ids",
            "description": "Alert channels; null: the account's default email channel"
          },
          "label": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 80
              },
              {
                "type": "null"
              }
            ],
            "title": "Label"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "kind",
          "target"
        ],
        "title": "CreateMonitor"
      },
      "CreateShareRequest": {
        "properties": {
          "source": {
            "$ref": "#/components/schemas/ShareSource"
          },
          "expires_in_days": {
            "type": "integer",
            "maximum": 90,
            "minimum": 1,
            "title": "Expires In Days",
            "description": "Days until the link stops working (1 to 90)",
            "default": 30
          },
          "password": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 128,
                "minLength": 8
              },
              {
                "type": "null"
              }
            ],
            "title": "Password",
            "description": "Optional: visitors must enter it to open the link. Never stored in plain text"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "source"
        ],
        "title": "CreateShareRequest"
      },
      "Credits": {
        "properties": {
          "balance": {
            "type": "integer",
            "title": "Balance"
          }
        },
        "type": "object",
        "required": [
          "balance"
        ],
        "title": "Credits"
      },
      "CspPolicy": {
        "properties": {
          "source": {
            "type": "string",
            "enum": [
              "header",
              "meta"
            ],
            "title": "Source"
          },
          "report_only": {
            "type": "boolean",
            "title": "Report Only"
          },
          "directives": {
            "additionalProperties": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "type": "object",
            "title": "Directives"
          },
          "weaknesses": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Weaknesses"
          },
          "upgrade_insecure_requests": {
            "type": "boolean",
            "title": "Upgrade Insecure Requests"
          }
        },
        "type": "object",
        "required": [
          "source",
          "report_only",
          "directives",
          "weaknesses",
          "upgrade_insecure_requests"
        ],
        "title": "CspPolicy"
      },
      "CsrDetails": {
        "properties": {
          "kind": {
            "type": "string",
            "const": "csr",
            "title": "Kind",
            "default": "csr"
          },
          "index": {
            "type": "integer",
            "title": "Index",
            "default": 0
          },
          "subject": {
            "type": "string",
            "title": "Subject"
          },
          "common_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Common Name"
          },
          "names": {
            "$ref": "#/components/schemas/Names"
          },
          "key": {
            "$ref": "#/components/schemas/KeyDetails"
          },
          "signature_algorithm": {
            "type": "string",
            "title": "Signature Algorithm"
          },
          "signature_valid": {
            "type": "boolean",
            "title": "Signature Valid"
          },
          "requested_extensions": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Requested Extensions"
          },
          "sha256": {
            "type": "string",
            "title": "Sha256"
          }
        },
        "type": "object",
        "required": [
          "subject",
          "common_name",
          "names",
          "key",
          "signature_algorithm",
          "signature_valid",
          "requested_extensions",
          "sha256"
        ],
        "title": "CsrDetails"
      },
      "DayState": {
        "type": "string",
        "enum": [
          "operational",
          "degraded",
          "outage",
          "no_data"
        ]
      },
      "DeliveryList": {
        "properties": {
          "deliveries": {
            "items": {
              "$ref": "#/components/schemas/DeliveryView"
            },
            "type": "array",
            "title": "Deliveries"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Cursor"
          }
        },
        "type": "object",
        "required": [
          "deliveries",
          "next_cursor"
        ],
        "title": "DeliveryList"
      },
      "DeliveryView": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "kind": {
            "type": "string",
            "title": "Kind"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "attempts": {
            "type": "integer",
            "title": "Attempts"
          },
          "status_class": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status Class",
            "description": "2xx, 3xx, 4xx or 5xx; never the exact code"
          },
          "error_code": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error Code"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          },
          "sent_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sent At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "kind",
          "status",
          "attempts",
          "status_class",
          "error_code",
          "created_at",
          "sent_at"
        ],
        "title": "DeliveryView"
      },
      "DenialData": {
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "nsec",
              "nsec3",
              "compact",
              "none",
              "unknown"
            ],
            "title": "Kind"
          },
          "nsec3_iterations": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Nsec3 Iterations"
          },
          "nsec3_salt_length": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Nsec3 Salt Length"
          },
          "nsec3_opt_out": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Nsec3 Opt Out"
          }
        },
        "type": "object",
        "required": [
          "kind"
        ],
        "title": "DenialData"
      },
      "DetailCode": {
        "type": "string",
        "enum": [
          "probe_failed",
          "slow_responses",
          "not_ready",
          "error_rate",
          "no_replica",
          "heartbeat_stale",
          "queue_backlog",
          "schedule_lag",
          "capacity_limited",
          "dns_slow",
          "dns_failures",
          "source_delays",
          "canary_failures",
          "send_failures",
          "webhook_errors",
          "api_unreachable",
          "planned_maintenance"
        ]
      },
      "Disclosure": {
        "properties": {
          "header": {
            "type": "string",
            "title": "Header"
          },
          "value": {
            "type": "string",
            "title": "Value"
          },
          "version": {
            "type": "string",
            "title": "Version"
          }
        },
        "type": "object",
        "required": [
          "header",
          "value",
          "version"
        ],
        "title": "Disclosure"
      },
      "DkimCheckerData": {
        "properties": {
          "source": {
            "type": "string",
            "enum": [
              "pasted",
              "dns"
            ],
            "title": "Source"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "record": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Record"
          },
          "query_status": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Query Status"
          },
          "version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Version"
          },
          "key_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Key Type"
          },
          "key_bits": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Key Bits"
          },
          "revoked": {
            "type": "boolean",
            "title": "Revoked"
          },
          "testing": {
            "type": "boolean",
            "title": "Testing"
          },
          "strict": {
            "type": "boolean",
            "title": "Strict"
          },
          "hash_algorithms": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Hash Algorithms"
          },
          "service_types": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Service Types"
          }
        },
        "type": "object",
        "required": [
          "source",
          "name",
          "record",
          "query_status",
          "version",
          "key_type",
          "key_bits",
          "revoked",
          "testing",
          "strict",
          "hash_algorithms",
          "service_types"
        ],
        "title": "DkimCheckerData",
        "description": "A DKIM record, pasted or looked up by selector, parsed into its key type, key size, flags and hash algorithms."
      },
      "DkimCheckerParams": {
        "properties": {
          "record": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 8192
              },
              {
                "type": "null"
              }
            ],
            "title": "Record",
            "description": "A DKIM record to check, pasted as text.",
            "x-mono": true,
            "x-widget": "textarea"
          },
          "domain": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ],
            "title": "Domain",
            "description": "Or a domain, with its selector, to look the record up.",
            "examples": [
              "example.com"
            ]
          },
          "selector": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 253,
                "pattern": "^[A-Za-z0-9_-]+(\\.[A-Za-z0-9_-]+)*$"
              },
              {
                "type": "null"
              }
            ],
            "title": "Selector",
            "description": "The DKIM selector, such as google or s1."
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "DkimCheckerParams"
      },
      "DkimCheckerResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/DkimCheckerData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "DkimCheckerResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "DkimData": {
        "properties": {
          "selectors_tried": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Selectors Tried"
          },
          "user_selector": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "User Selector"
          },
          "failed": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Failed"
          },
          "found": {
            "items": {
              "$ref": "#/components/schemas/DkimFoundData"
            },
            "type": "array",
            "title": "Found"
          }
        },
        "type": "object",
        "required": [
          "selectors_tried",
          "user_selector",
          "failed",
          "found"
        ],
        "title": "DkimData"
      },
      "DkimFoundData": {
        "properties": {
          "selector": {
            "type": "string",
            "title": "Selector"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "status": {
            "type": "string",
            "enum": [
              "ok",
              "weak",
              "invalid",
              "revoked"
            ],
            "title": "Status"
          },
          "key_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Key Type"
          },
          "key_bits": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Key Bits"
          },
          "testing": {
            "type": "boolean",
            "title": "Testing"
          },
          "hash_algorithms": {
            "anyOf": [
              {
                "items": {
                  "type": "string"
                },
                "type": "array"
              },
              {
                "type": "null"
              }
            ],
            "title": "Hash Algorithms"
          },
          "provider": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Provider"
          },
          "record": {
            "type": "string",
            "title": "Record"
          }
        },
        "type": "object",
        "required": [
          "selector",
          "name",
          "status",
          "key_type",
          "key_bits",
          "testing",
          "hash_algorithms",
          "provider",
          "record"
        ],
        "title": "DkimFoundData"
      },
      "DkimVerifierData": {
        "properties": {
          "message_bytes": {
            "type": "integer",
            "title": "Message Bytes"
          },
          "line_endings_converted": {
            "type": "boolean",
            "title": "Line Endings Converted"
          },
          "from_domain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "From Domain"
          },
          "signatures": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array",
            "title": "Signatures"
          },
          "unverified_signatures": {
            "type": "integer",
            "title": "Unverified Signatures"
          },
          "arc": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Arc"
          },
          "aligned_pass": {
            "type": "boolean",
            "title": "Aligned Pass"
          }
        },
        "type": "object",
        "required": [
          "message_bytes",
          "line_endings_converted",
          "from_domain",
          "signatures",
          "unverified_signatures",
          "arc",
          "aligned_pass"
        ],
        "title": "DkimVerifierData",
        "description": "Each DKIM signature of a pasted or uploaded message, verified against the key in DNS, and its ARC chain."
      },
      "DkimVerifierParams": {
        "properties": {
          "message": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 4194304
              },
              {
                "type": "null"
              }
            ],
            "title": "Raw message",
            "description": "The whole message as received, headers and body, exactly as \"Show original\" shows it.",
            "x-mono": true,
            "x-widget": "textarea"
          },
          "message_base64": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 5592408
              },
              {
                "type": "null"
              }
            ],
            "title": "Message file",
            "description": "The .eml file, base64-encoded. Send either this or the pasted message, not both.",
            "x-accept": ".eml,message/rfc822",
            "x-widget": "file"
          },
          "verify_arc": {
            "type": "boolean",
            "title": "Verify Arc",
            "description": "Also verify the ARC chain that forwarders and mailing lists add.",
            "default": true,
            "x-advanced": true
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "DkimVerifierParams"
      },
      "DkimVerifierResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/DkimVerifierData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "DkimVerifierResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "DmarcBuild": {
        "properties": {
          "rollout": {
            "items": {
              "$ref": "#/components/schemas/DmarcRolloutStage"
            },
            "type": "array",
            "title": "Rollout"
          },
          "report_authorizations": {
            "items": {
              "$ref": "#/components/schemas/ReportAuthorization"
            },
            "type": "array",
            "title": "Report Authorizations"
          }
        },
        "type": "object",
        "required": [
          "rollout",
          "report_authorizations"
        ],
        "title": "DmarcBuild"
      },
      "DmarcData": {
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "found",
              "missing",
              "multiple",
              "failed"
            ],
            "title": "Status"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "source": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "exact",
                  "organizational"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Source"
          },
          "record": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Record"
          },
          "policy": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Policy"
          },
          "subdomain_policy": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Subdomain Policy"
          },
          "effective_policy": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Effective Policy"
          },
          "pct": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pct"
          },
          "adkim": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Adkim"
          },
          "aspf": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Aspf"
          },
          "reports": {
            "items": {
              "$ref": "#/components/schemas/DmarcReportData"
            },
            "type": "array",
            "title": "Reports"
          }
        },
        "type": "object",
        "required": [
          "status",
          "name",
          "source",
          "record",
          "policy",
          "subdomain_policy",
          "effective_policy",
          "pct",
          "adkim",
          "aspf",
          "reports"
        ],
        "title": "DmarcData"
      },
      "DmarcGeneratorData": {
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "spf",
              "dmarc",
              "caa"
            ],
            "title": "Kind"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "type": {
            "type": "string",
            "enum": [
              "TXT",
              "CAA"
            ],
            "title": "Type"
          },
          "value": {
            "type": "string",
            "title": "Value"
          },
          "strings": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Strings"
          },
          "length": {
            "type": "integer",
            "title": "Length"
          },
          "zone_line": {
            "type": "string",
            "title": "Zone Line"
          },
          "mode": {
            "type": "string",
            "enum": [
              "build",
              "validate"
            ],
            "title": "Mode"
          },
          "spf": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SpfBuild"
              },
              {
                "type": "null"
              }
            ]
          },
          "dmarc": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DmarcBuild"
              },
              {
                "type": "null"
              }
            ]
          },
          "caa": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaaBuild"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "kind",
          "name",
          "type",
          "value",
          "strings",
          "length",
          "zone_line",
          "mode"
        ],
        "title": "DmarcGeneratorData",
        "description": "A DMARC record built from your choices, with a rollout plan and the authorization records external report addresses need."
      },
      "DmarcGeneratorParams": {
        "properties": {
          "domain": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ],
            "title": "Domain",
            "description": "Your domain; names the record and checks report addresses.",
            "examples": [
              "example.com"
            ]
          },
          "policy": {
            "type": "string",
            "enum": [
              "none",
              "quarantine",
              "reject"
            ],
            "title": "Policy",
            "description": "What receivers do with mail that fails DMARC."
          },
          "subdomain_policy": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "none",
                  "quarantine",
                  "reject"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Subdomain Policy",
            "description": "A different policy for subdomains; leave empty to use the main policy."
          },
          "pct": {
            "type": "integer",
            "maximum": 100,
            "minimum": 0,
            "title": "Pct",
            "description": "Percentage of failing mail the policy applies to.",
            "default": 100
          },
          "rua": {
            "anyOf": [
              {
                "items": {
                  "type": "string",
                  "maxLength": 254
                },
                "type": "array",
                "maxItems": 5
              },
              {
                "type": "null"
              }
            ],
            "title": "Rua",
            "description": "Addresses for daily aggregate reports, one per line.",
            "x-widget": "lines"
          },
          "ruf": {
            "anyOf": [
              {
                "items": {
                  "type": "string",
                  "maxLength": 254
                },
                "type": "array",
                "maxItems": 5
              },
              {
                "type": "null"
              }
            ],
            "title": "Ruf",
            "description": "Addresses for failure reports, one per line.",
            "x-advanced": true,
            "x-widget": "lines"
          },
          "adkim": {
            "type": "string",
            "enum": [
              "r",
              "s"
            ],
            "title": "Adkim",
            "description": "DKIM alignment, relaxed or strict.",
            "default": "r",
            "x-advanced": true
          },
          "aspf": {
            "type": "string",
            "enum": [
              "r",
              "s"
            ],
            "title": "Aspf",
            "description": "SPF alignment, relaxed or strict.",
            "default": "r",
            "x-advanced": true
          },
          "fo": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "0",
                  "1",
                  "d",
                  "s"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Fo",
            "description": "When failure reports are sent.",
            "x-advanced": true
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "policy"
        ],
        "title": "DmarcGeneratorParams"
      },
      "DmarcGeneratorResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/DmarcGeneratorData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "DmarcGeneratorResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "DmarcReportData": {
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "rua",
              "ruf"
            ],
            "title": "Kind"
          },
          "uri": {
            "type": "string",
            "title": "Uri"
          },
          "domain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Domain"
          },
          "external": {
            "type": "boolean",
            "title": "External"
          },
          "authorized": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Authorized"
          }
        },
        "type": "object",
        "required": [
          "kind",
          "uri",
          "domain",
          "external",
          "authorized"
        ],
        "title": "DmarcReportData"
      },
      "DmarcRolloutStage": {
        "properties": {
          "stage": {
            "type": "integer",
            "title": "Stage"
          },
          "policy": {
            "type": "string",
            "title": "Policy"
          },
          "value": {
            "type": "string",
            "title": "Value"
          },
          "when": {
            "type": "string",
            "title": "When"
          }
        },
        "type": "object",
        "required": [
          "stage",
          "policy",
          "value",
          "when"
        ],
        "title": "DmarcRolloutStage"
      },
      "DnsMigrationCheckerParams": {
        "properties": {
          "domain": {
            "type": "string",
            "maxLength": 2048,
            "minLength": 1,
            "title": "Domain",
            "description": "The zone you are moving, such as example.com.",
            "examples": [
              "example.com"
            ]
          },
          "new_nameservers": {
            "items": {
              "type": "string",
              "maxLength": 253
            },
            "type": "array",
            "maxItems": 13,
            "minItems": 1,
            "title": "New Nameservers",
            "description": "The new provider's nameservers, one per line.",
            "x-widget": "lines"
          },
          "names": {
            "anyOf": [
              {
                "items": {
                  "type": "string",
                  "maxLength": 253
                },
                "type": "array",
                "maxItems": 50,
                "minItems": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Names",
            "description": "Extra names to compare, such as www or mail, one per line.",
            "x-widget": "lines"
          },
          "fresh": {
            "type": "boolean",
            "title": "Fresh",
            "description": "Skip the cache and ask the source again; costs the same.",
            "default": false
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "domain",
          "new_nameservers"
        ],
        "title": "DnsMigrationCheckerParams"
      },
      "DnssecCheckerData": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name",
            "description": "The name asked about, in ASCII"
          },
          "unicode": {
            "type": "string",
            "title": "Unicode"
          },
          "zone": {
            "type": "string",
            "title": "Zone",
            "description": "The zone checked: the name itself or the zone it lives in"
          },
          "parent": {
            "type": "string",
            "title": "Parent"
          },
          "dnssec": {
            "type": "string",
            "enum": [
              "secure",
              "insecure",
              "bogus",
              "indeterminate"
            ],
            "title": "Dnssec"
          },
          "extended_errors": {
            "items": {
              "$ref": "#/components/schemas/ExtendedErrorRow"
            },
            "type": "array",
            "title": "Extended Errors"
          },
          "chain": {
            "items": {
              "$ref": "#/components/schemas/ChainLink"
            },
            "type": "array",
            "title": "Chain"
          },
          "ds": {
            "items": {
              "$ref": "#/components/schemas/DsRow"
            },
            "type": "array",
            "title": "Ds"
          },
          "dnskeys": {
            "items": {
              "$ref": "#/components/schemas/KeyRow"
            },
            "type": "array",
            "title": "Dnskeys"
          },
          "signatures": {
            "items": {
              "$ref": "#/components/schemas/SignatureRow"
            },
            "type": "array",
            "title": "Signatures"
          },
          "denial": {
            "$ref": "#/components/schemas/DenialData"
          },
          "parent_ns": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Parent Ns"
          },
          "parent_ns_ttl": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Parent Ns Ttl"
          },
          "child_ns": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Child Ns"
          },
          "nameservers": {
            "items": {
              "$ref": "#/components/schemas/NameserverRow"
            },
            "type": "array",
            "title": "Nameservers"
          },
          "serials": {
            "additionalProperties": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "type": "object",
            "title": "Serials",
            "description": "Serial number -> addresses serving it"
          },
          "ipv6_checked": {
            "type": "boolean",
            "title": "Ipv6 Checked"
          },
          "min_ttl": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Min Ttl"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "name",
          "unicode",
          "zone",
          "parent",
          "dnssec",
          "extended_errors",
          "chain",
          "ds",
          "dnskeys",
          "signatures",
          "denial",
          "parent_ns",
          "child_ns",
          "nameservers",
          "serials",
          "ipv6_checked"
        ],
        "title": "DnssecCheckerData",
        "description": "The zone's delegation, nameservers and DNSSEC chain of trust."
      },
      "DnssecCheckerResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/DnssecCheckerData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "DnssecCheckerResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "DomainAvailabilityData": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "unicode": {
            "type": "string",
            "title": "Unicode"
          },
          "tld": {
            "type": "string",
            "title": "Tld"
          },
          "tier": {
            "type": "string",
            "enum": [
              "A",
              "B",
              "C",
              "D"
            ],
            "title": "Tier"
          },
          "reduced_from": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reduced From"
          },
          "verdict": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Verdict"
              },
              {
                "type": "null"
              }
            ]
          },
          "certainty": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Certainty"
              },
              {
                "type": "null"
              }
            ]
          },
          "reason": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/dnssuper_core__tools__domain_availability__Reason"
              },
              {
                "type": "null"
              }
            ]
          },
          "may_become_available": {
            "type": "boolean",
            "title": "May Become Available",
            "default": false
          },
          "statuses": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Statuses"
          },
          "source": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "dns",
                  "rdap",
                  "whois",
                  "dns-only"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Source"
          },
          "steps": {
            "items": {
              "$ref": "#/components/schemas/Step"
            },
            "type": "array",
            "title": "Steps"
          },
          "price_note": {
            "type": "boolean",
            "title": "Price Note",
            "default": true
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          }
        },
        "type": "object",
        "required": [
          "name",
          "unicode",
          "tld",
          "tier"
        ],
        "title": "DomainAvailabilityData",
        "description": "`data` of a domain-availability envelope (and of each bulk item)."
      },
      "DomainAvailabilityResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/DomainAvailabilityData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "DomainAvailabilityResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "DomainExpiryCalendarParams": {
        "properties": {
          "domains": {
            "items": {
              "type": "string",
              "maxLength": 253
            },
            "type": "array",
            "maxItems": 200,
            "minItems": 1,
            "title": "Domains",
            "description": "Up to 200 domains, one per line.",
            "x-widget": "lines"
          },
          "fresh": {
            "type": "boolean",
            "title": "Fresh",
            "description": "Skip the cache and ask the registries again; costs the same.",
            "default": false
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "domains"
        ],
        "title": "DomainExpiryCalendarParams"
      },
      "DomainReportCheck": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "status": {
            "type": "string",
            "enum": [
              "ok",
              "partial",
              "error",
              "skipped"
            ],
            "title": "Status"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "fetched_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Fetched At"
          },
          "summary": {
            "type": "string",
            "title": "Summary",
            "default": ""
          },
          "score": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "additionalProperties": true,
            "type": "object",
            "title": "Data"
          },
          "error": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DomainReportSectionError"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "tool",
          "status"
        ],
        "title": "DomainReportCheck",
        "description": "One sub-tool's result inside a section."
      },
      "DomainReportData": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "unicode": {
            "type": "string",
            "title": "Unicode"
          },
          "registrable": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Registrable"
          },
          "grade": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Grade"
          },
          "sections": {
            "additionalProperties": {
              "$ref": "#/components/schemas/DomainReportSection"
            },
            "type": "object",
            "title": "Sections"
          },
          "facts": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DomainReportFacts"
              },
              {
                "type": "null"
              }
            ]
          },
          "section_order": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Section Order"
          }
        },
        "type": "object",
        "required": [
          "name",
          "unicode",
          "registrable",
          "grade",
          "sections",
          "facts",
          "section_order"
        ],
        "title": "DomainReportData",
        "description": "One graded report on a domain: DNS with DNSSEC and nameservers, registration, email setup, SSL and the website's HTTPS and security headers, each with its own grade, plus facts such as age and hosting."
      },
      "DomainReportFacts": {
        "properties": {
          "domain_age_days": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Domain Age Days"
          },
          "created": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created"
          },
          "expires": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expires"
          },
          "days_to_expiry": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Days To Expiry"
          },
          "registrar": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Registrar"
          },
          "dns_host": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DomainReportNamedFact"
              },
              {
                "type": "null"
              }
            ]
          },
          "mail_provider": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DomainReportNamedFact"
              },
              {
                "type": "null"
              }
            ]
          },
          "web_host": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DomainReportNamedFact"
              },
              {
                "type": "null"
              }
            ]
          },
          "addresses": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Addresses"
          },
          "network": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/NetworkData"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "title": "DomainReportFacts"
      },
      "DomainReportNamedFact": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "source": {
            "type": "string",
            "title": "Source"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "source"
        ],
        "title": "DomainReportNamedFact"
      },
      "DomainReportResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/DomainReportData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "DomainReportResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "DomainReportSection": {
        "properties": {
          "section": {
            "type": "string",
            "title": "Section"
          },
          "status": {
            "type": "string",
            "enum": [
              "ok",
              "partial",
              "error",
              "skipped"
            ],
            "title": "Status"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "grade": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Grade"
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "error": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DomainReportSectionError"
              },
              {
                "type": "null"
              }
            ]
          },
          "checks": {
            "items": {
              "$ref": "#/components/schemas/DomainReportCheck"
            },
            "type": "array",
            "title": "Checks"
          }
        },
        "type": "object",
        "required": [
          "section",
          "status",
          "summary"
        ],
        "title": "DomainReportSection"
      },
      "DomainReportSectionError": {
        "properties": {
          "code": {
            "type": "string",
            "enum": [
              "source_unavailable",
              "timeout",
              "internal_error"
            ],
            "title": "Code"
          },
          "message": {
            "type": "string",
            "title": "Message"
          }
        },
        "type": "object",
        "required": [
          "code",
          "message"
        ],
        "title": "DomainReportSectionError"
      },
      "DsRow": {
        "properties": {
          "key_tag": {
            "type": "integer",
            "title": "Key Tag"
          },
          "algorithm": {
            "type": "integer",
            "title": "Algorithm"
          },
          "algorithm_name": {
            "type": "string",
            "title": "Algorithm Name"
          },
          "digest_type": {
            "type": "integer",
            "title": "Digest Type"
          },
          "matches_key": {
            "type": "boolean",
            "title": "Matches Key"
          }
        },
        "type": "object",
        "required": [
          "key_tag",
          "algorithm",
          "algorithm_name",
          "digest_type",
          "matches_key"
        ],
        "title": "DsRow"
      },
      "EmailCheckerData": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "unicode": {
            "type": "string",
            "title": "Unicode"
          },
          "nxdomain": {
            "type": "boolean",
            "title": "Nxdomain"
          },
          "providers": {
            "items": {
              "$ref": "#/components/schemas/ProviderData"
            },
            "type": "array",
            "title": "Providers"
          },
          "mx": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MxData"
              },
              {
                "type": "null"
              }
            ]
          },
          "spf": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SpfData"
              },
              {
                "type": "null"
              }
            ]
          },
          "dmarc": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DmarcData"
              },
              {
                "type": "null"
              }
            ]
          },
          "dkim": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DkimData"
              },
              {
                "type": "null"
              }
            ]
          },
          "policies": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PoliciesData"
              },
              {
                "type": "null"
              }
            ]
          },
          "min_ttl": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Min Ttl"
          }
        },
        "type": "object",
        "required": [
          "name",
          "unicode",
          "nxdomain"
        ],
        "title": "EmailCheckerData",
        "description": "The domain's MX, SPF (with its lookup count), DMARC and DKIM records, the mail provider they point to, and the findings that set the grade."
      },
      "EmailCheckerResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/EmailCheckerData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "EmailCheckerResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "EmailHeaderAnalyzerData": {
        "properties": {
          "header_count": {
            "type": "integer",
            "title": "Header Count"
          },
          "received_count": {
            "type": "integer",
            "title": "Received Count"
          },
          "hops": {
            "items": {
              "$ref": "#/components/schemas/HopData"
            },
            "type": "array",
            "title": "Hops"
          },
          "total_transit_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total Transit S"
          },
          "auth_results": {
            "items": {
              "$ref": "#/components/schemas/AuthResultsData"
            },
            "type": "array",
            "title": "Auth Results"
          },
          "alignment": {
            "$ref": "#/components/schemas/AlignmentData"
          },
          "arc_instances": {
            "type": "integer",
            "title": "Arc Instances"
          },
          "arc_cv": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Arc Cv"
          },
          "message_id_domain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Message Id Domain"
          },
          "sending_software": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Sending Software"
          },
          "unsubscribe": {
            "additionalProperties": {
              "type": "boolean"
            },
            "type": "object",
            "title": "Unsubscribe"
          },
          "spam": {
            "items": {
              "additionalProperties": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "type": "object"
            },
            "type": "array",
            "title": "Spam"
          },
          "public_ips": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Public Ips"
          },
          "verdict": {
            "type": "string",
            "enum": [
              "dmarc_pass",
              "dmarc_fail",
              "no_dmarc",
              "unknown"
            ],
            "title": "Verdict"
          }
        },
        "type": "object",
        "required": [
          "header_count",
          "received_count",
          "hops",
          "total_transit_s",
          "auth_results",
          "alignment",
          "arc_instances",
          "arc_cv",
          "message_id_domain",
          "sending_software",
          "unsubscribe",
          "spam",
          "public_ips",
          "verdict"
        ],
        "title": "EmailHeaderAnalyzerData",
        "description": "The delivery path, authentication results and alignment read from pasted email headers."
      },
      "EmailHeaderAnalyzerParams": {
        "properties": {
          "headers": {
            "type": "string",
            "maxLength": 262144,
            "minLength": 1,
            "title": "Headers",
            "description": "The message headers, copied with \"Show original\" or \"View source\". A whole message works too; only the headers are read.",
            "x-mono": true,
            "x-widget": "textarea"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "headers"
        ],
        "title": "EmailHeaderAnalyzerParams"
      },
      "EmailHeaderAnalyzerResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/EmailHeaderAnalyzerData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "EmailHeaderAnalyzerResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "EntryPoint": {
        "properties": {
          "start_url": {
            "type": "string",
            "title": "Start Url"
          },
          "final_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Final Url"
          },
          "final_status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Final Status"
          },
          "hops": {
            "items": {
              "$ref": "#/components/schemas/HopOut"
            },
            "type": "array",
            "title": "Hops"
          },
          "outcome": {
            "type": "string",
            "enum": [
              "ok",
              "loop",
              "too_many",
              "no_address",
              "connect",
              "refused",
              "tls_failed",
              "timeout",
              "blocked",
              "ipv6_only",
              "error"
            ],
            "title": "Outcome"
          }
        },
        "type": "object",
        "required": [
          "start_url",
          "final_url",
          "final_status",
          "hops",
          "outcome"
        ],
        "title": "EntryPoint"
      },
      "ErrorBody": {
        "properties": {
          "error": {
            "$ref": "#/components/schemas/ErrorDetail"
          }
        },
        "type": "object",
        "required": [
          "error"
        ],
        "title": "ErrorBody"
      },
      "ErrorCode": {
        "type": "string",
        "enum": [
          "disallowed",
          "contextj",
          "contexto",
          "bidi",
          "hyphen",
          "length",
          "punycode"
        ]
      },
      "ErrorDetail": {
        "properties": {
          "code": {
            "type": "string",
            "enum": [
              "invalid_domain",
              "invalid_request",
              "invalid_url",
              "unsupported_tld",
              "token_invalid",
              "unauthorized",
              "insufficient_credits",
              "account_suspended",
              "challenge_required",
              "sign_in_required",
              "bulk_locked",
              "forbidden",
              "plan_limit",
              "password_required",
              "not_found",
              "method_not_allowed",
              "conflict",
              "rate_limited",
              "free_limit_reached",
              "busy",
              "too_many_jobs",
              "site_busy",
              "browser_busy",
              "crawl_busy",
              "source_unavailable",
              "billing_unavailable",
              "internal_error",
              "bulk_busy",
              "plan_kind",
              "interval_not_allowed",
              "channel_not_allowed",
              "duplicate_monitor",
              "alerts_off",
              "verification_required",
              "private_key_refused",
              "lookalike_busy",
              "export_too_large",
              "export_busy",
              "no_members",
              "channel_limit",
              "channel_unverified",
              "reauth_required",
              "sole_owner"
            ],
            "title": "Code"
          },
          "message": {
            "type": "string",
            "title": "Message"
          },
          "request_id": {
            "type": "string",
            "title": "Request Id"
          }
        },
        "type": "object",
        "required": [
          "code",
          "message",
          "request_id"
        ],
        "title": "ErrorDetail"
      },
      "Event": {
        "properties": {
          "id": {
            "type": "integer",
            "title": "Id"
          },
          "kind": {
            "type": "string",
            "title": "Kind"
          },
          "severity": {
            "type": "string",
            "title": "Severity"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "field": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Field"
          },
          "finding_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Finding Id"
          },
          "before": {
            "title": "Before"
          },
          "after": {
            "title": "After"
          },
          "occurred_at": {
            "type": "string",
            "format": "date-time",
            "title": "Occurred At"
          },
          "alerted": {
            "type": "boolean",
            "title": "Alerted"
          }
        },
        "type": "object",
        "required": [
          "id",
          "kind",
          "severity",
          "title",
          "field",
          "finding_id",
          "before",
          "after",
          "occurred_at",
          "alerted"
        ],
        "title": "Event"
      },
      "EventList": {
        "properties": {
          "events": {
            "items": {
              "$ref": "#/components/schemas/Event"
            },
            "type": "array",
            "title": "Events"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Cursor"
          }
        },
        "type": "object",
        "required": [
          "events",
          "next_cursor"
        ],
        "title": "EventList"
      },
      "Evidence": {
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "header",
              "cookie",
              "meta",
              "script_src",
              "link_href",
              "html",
              "html_attr",
              "txt",
              "ns",
              "cname",
              "mx",
              "ptr",
              "asn",
              "implied"
            ],
            "title": "Kind"
          },
          "detail": {
            "type": "string",
            "title": "Detail"
          }
        },
        "type": "object",
        "required": [
          "kind",
          "detail"
        ],
        "title": "Evidence"
      },
      "ExportFormat": {
        "type": "string",
        "enum": [
          "json",
          "csv",
          "pdf",
          "ics"
        ]
      },
      "ExportRequest": {
        "properties": {
          "source": {
            "oneOf": [
              {
                "$ref": "#/components/schemas/CallSource"
              },
              {
                "$ref": "#/components/schemas/JobSource"
              },
              {
                "$ref": "#/components/schemas/CompareSource"
              },
              {
                "$ref": "#/components/schemas/MonitorSource"
              }
            ],
            "title": "Source",
            "description": "What to export: a call, a job, a compare or a monitor",
            "discriminator": {
              "propertyName": "kind",
              "mapping": {
                "call": "#/components/schemas/CallSource",
                "compare": "#/components/schemas/CompareSource",
                "job": "#/components/schemas/JobSource",
                "monitor": "#/components/schemas/MonitorSource"
              }
            }
          },
          "format": {
            "$ref": "#/components/schemas/ExportFormat"
          },
          "branding": {
            "type": "string",
            "enum": [
              "auto",
              "none"
            ],
            "title": "Branding",
            "description": "auto: a white-label PDF when your plan allows it and you saved branding",
            "default": "auto"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "source",
          "format"
        ],
        "title": "ExportRequest"
      },
      "ExportView": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "format": {
            "type": "string",
            "const": "pdf",
            "title": "Format"
          },
          "status": {
            "type": "string",
            "enum": [
              "queued",
              "running",
              "done",
              "failed"
            ],
            "title": "Status"
          },
          "source_kind": {
            "type": "string",
            "title": "Source Kind"
          },
          "white_label": {
            "type": "boolean",
            "title": "White Label"
          },
          "filename": {
            "type": "string",
            "title": "Filename"
          },
          "pages": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pages"
          },
          "size_bytes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Size Bytes"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          },
          "finished_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Finished At"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time",
            "title": "Expires At"
          },
          "error": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ErrorBody"
              },
              {
                "type": "null"
              }
            ]
          },
          "file_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "File Url",
            "description": "Where to download the PDF once it is done (the same auth)"
          }
        },
        "type": "object",
        "required": [
          "id",
          "format",
          "status",
          "source_kind",
          "white_label",
          "filename",
          "pages",
          "size_bytes",
          "created_at",
          "finished_at",
          "expires_at",
          "error"
        ],
        "title": "ExportView"
      },
      "ExportsPage": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/ExportView"
            },
            "type": "array",
            "title": "Items"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Cursor"
          }
        },
        "type": "object",
        "required": [
          "items",
          "next_cursor"
        ],
        "title": "ExportsPage"
      },
      "ExtendedErrorRow": {
        "properties": {
          "code": {
            "type": "integer",
            "title": "Code"
          },
          "text": {
            "type": "string",
            "title": "Text"
          }
        },
        "type": "object",
        "required": [
          "code",
          "text"
        ],
        "title": "ExtendedErrorRow"
      },
      "Finding": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "severity": {
            "$ref": "#/components/schemas/Severity"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "detail": {
            "type": "string",
            "title": "Detail",
            "default": ""
          },
          "fix": {
            "type": "string",
            "title": "Fix",
            "default": ""
          }
        },
        "type": "object",
        "required": [
          "id",
          "severity",
          "title"
        ],
        "title": "Finding",
        "description": "One check result. `id` is stable (`dns.no_aaaa`) so monitoring can tell when it appears or clears."
      },
      "HopData": {
        "properties": {
          "index": {
            "type": "integer",
            "title": "Index"
          },
          "from_helo": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "From Helo"
          },
          "from_rdns": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "From Rdns"
          },
          "from_ip": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "From Ip"
          },
          "ip_scope": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/HopScope"
              },
              {
                "type": "null"
              }
            ]
          },
          "by_host": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "By Host"
          },
          "protocol": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Protocol"
          },
          "tls": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Tls"
          },
          "queue_id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Queue Id"
          },
          "received_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Received At"
          },
          "delay_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Delay S"
          },
          "clock_skew": {
            "type": "boolean",
            "title": "Clock Skew"
          },
          "largest_delay": {
            "type": "boolean",
            "title": "Largest Delay"
          },
          "boundary": {
            "type": "boolean",
            "title": "Boundary"
          },
          "network": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/NetworkData"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "index",
          "from_helo",
          "from_rdns",
          "from_ip",
          "ip_scope",
          "by_host",
          "protocol",
          "tls",
          "queue_id",
          "received_at",
          "delay_s",
          "clock_skew",
          "largest_delay",
          "boundary"
        ],
        "title": "HopData"
      },
      "HopOut": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "status": {
            "type": "integer",
            "title": "Status"
          },
          "location": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Location"
          },
          "elapsed_ms": {
            "type": "integer",
            "title": "Elapsed Ms"
          },
          "cookie_names": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Cookie Names"
          },
          "kind": {
            "type": "string",
            "enum": [
              "http",
              "meta-refresh",
              "js"
            ],
            "title": "Kind",
            "default": "http"
          }
        },
        "type": "object",
        "required": [
          "url",
          "status",
          "location",
          "elapsed_ms",
          "cookie_names"
        ],
        "title": "HopOut"
      },
      "HopScope": {
        "type": "string",
        "enum": [
          "public",
          "private",
          "loopback",
          "link_local",
          "cgnat",
          "reserved",
          "documentation"
        ]
      },
      "HostError": {
        "properties": {
          "code": {
            "type": "string",
            "title": "Code"
          },
          "message": {
            "type": "string",
            "title": "Message"
          }
        },
        "type": "object",
        "required": [
          "code",
          "message"
        ],
        "title": "HostError"
      },
      "HostStatus": {
        "type": "string",
        "enum": [
          "ok",
          "no_address",
          "ipv6_only",
          "refused",
          "closed",
          "not_tls",
          "handshake_failed",
          "timeout",
          "dns_failed"
        ]
      },
      "HstsInfo": {
        "properties": {
          "present": {
            "type": "boolean",
            "title": "Present"
          },
          "max_age": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Max Age"
          },
          "include_subdomains": {
            "type": "boolean",
            "title": "Include Subdomains"
          },
          "preload": {
            "type": "boolean",
            "title": "Preload"
          },
          "problems": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Problems"
          }
        },
        "type": "object",
        "required": [
          "present",
          "max_age",
          "include_subdomains",
          "preload",
          "problems"
        ],
        "title": "HstsInfo"
      },
      "HttpCell": {
        "properties": {
          "status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "redirect_to": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Redirect To"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          }
        },
        "type": "object",
        "required": [
          "status",
          "redirect_to",
          "error"
        ],
        "title": "HttpCell"
      },
      "IconOut": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "source": {
            "type": "string",
            "enum": [
              "jsonld",
              "apple-touch-icon",
              "icon",
              "manifest",
              "og:image",
              "favicon.ico"
            ],
            "title": "Source"
          },
          "declared_sizes": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Declared Sizes"
          },
          "info": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ImageInfoOut"
              },
              {
                "type": "null"
              }
            ]
          },
          "status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "display": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Display"
          },
          "problem": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Problem"
          }
        },
        "type": "object",
        "required": [
          "url",
          "source",
          "declared_sizes",
          "info",
          "status",
          "display",
          "problem"
        ],
        "title": "IconOut"
      },
      "IdnChar": {
        "properties": {
          "char": {
            "type": "string",
            "title": "Char"
          },
          "codepoint": {
            "type": "string",
            "title": "Codepoint",
            "description": "U+XXXX"
          },
          "name": {
            "type": "string",
            "title": "Name",
            "description": "Unicode name; empty when unknown to our database."
          },
          "scripts": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Scripts"
          },
          "identifier": {
            "type": "string",
            "enum": [
              "allowed",
              "restricted"
            ],
            "title": "Identifier"
          },
          "confusable_with": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Confusable With",
            "description": "The character's confusable prototype (UTS 39), when it has one."
          }
        },
        "type": "object",
        "required": [
          "char",
          "codepoint",
          "name",
          "scripts",
          "identifier",
          "confusable_with"
        ],
        "title": "IdnChar"
      },
      "IdnDisplay": {
        "properties": {
          "likely": {
            "type": "string",
            "enum": [
              "unicode",
              "punycode"
            ],
            "title": "Likely"
          },
          "reason": {
            "type": "string",
            "title": "Reason"
          }
        },
        "type": "object",
        "required": [
          "likely",
          "reason"
        ],
        "title": "IdnDisplay"
      },
      "IdnLabel": {
        "properties": {
          "unicode": {
            "type": "string",
            "title": "Unicode"
          },
          "ascii": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ascii",
            "description": "The A-label or ASCII label; null when invalid."
          },
          "valid": {
            "type": "boolean",
            "title": "Valid"
          },
          "error": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/IdnLabelError"
              },
              {
                "type": "null"
              }
            ]
          },
          "scripts": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Scripts"
          },
          "mixed_script": {
            "type": "boolean",
            "title": "Mixed Script"
          },
          "restriction": {
            "$ref": "#/components/schemas/RestrictionLevel"
          },
          "chars": {
            "items": {
              "$ref": "#/components/schemas/IdnChar"
            },
            "type": "array",
            "title": "Chars",
            "description": "Non-ASCII characters, at most 63."
          },
          "skeleton": {
            "type": "string",
            "title": "Skeleton"
          },
          "imitates_ascii": {
            "type": "boolean",
            "title": "Imitates Ascii"
          }
        },
        "type": "object",
        "required": [
          "unicode",
          "ascii",
          "valid",
          "error",
          "scripts",
          "mixed_script",
          "restriction",
          "chars",
          "skeleton",
          "imitates_ascii"
        ],
        "title": "IdnLabel"
      },
      "IdnLabelError": {
        "properties": {
          "code": {
            "$ref": "#/components/schemas/ErrorCode"
          },
          "codepoint": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Codepoint",
            "description": "The character at fault, as U+XXXX, when one is."
          },
          "message": {
            "type": "string",
            "title": "Message"
          }
        },
        "type": "object",
        "required": [
          "code",
          "codepoint",
          "message"
        ],
        "title": "IdnLabelError"
      },
      "ImageInfoOut": {
        "properties": {
          "format": {
            "type": "string",
            "title": "Format"
          },
          "width": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Width"
          },
          "height": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Height"
          },
          "bytes": {
            "type": "integer",
            "title": "Bytes"
          },
          "content_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Content Type"
          },
          "type_matches": {
            "type": "boolean",
            "title": "Type Matches"
          },
          "animated": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Animated"
          }
        },
        "type": "object",
        "required": [
          "format",
          "width",
          "height",
          "bytes",
          "content_type",
          "type_matches",
          "animated"
        ],
        "title": "ImageInfoOut"
      },
      "Incident": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "kind": {
            "type": "string",
            "enum": [
              "incident",
              "maintenance"
            ],
            "title": "Kind"
          },
          "title": {
            "type": "string",
            "title": "Title"
          },
          "impact": {
            "type": "string",
            "enum": [
              "minor",
              "major"
            ],
            "title": "Impact"
          },
          "state": {
            "type": "string",
            "title": "State"
          },
          "components": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Components"
          },
          "scheduled_start": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Scheduled Start"
          },
          "scheduled_end": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Scheduled End"
          },
          "started_at": {
            "type": "string",
            "format": "date-time",
            "title": "Started At"
          },
          "resolved_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Resolved At"
          },
          "updates": {
            "items": {
              "$ref": "#/components/schemas/IncidentUpdate"
            },
            "type": "array",
            "title": "Updates"
          }
        },
        "type": "object",
        "required": [
          "id",
          "kind",
          "title",
          "impact",
          "state",
          "components",
          "started_at"
        ],
        "title": "Incident"
      },
      "IncidentUpdate": {
        "properties": {
          "at": {
            "type": "string",
            "format": "date-time",
            "title": "At"
          },
          "state": {
            "type": "string",
            "title": "State"
          },
          "body": {
            "type": "string",
            "title": "Body"
          }
        },
        "type": "object",
        "required": [
          "at",
          "state",
          "body"
        ],
        "title": "IncidentUpdate"
      },
      "IpLookupData": {
        "properties": {
          "address": {
            "type": "string",
            "title": "Address"
          },
          "version": {
            "type": "integer",
            "title": "Version"
          },
          "scope": {
            "type": "string",
            "title": "Scope"
          },
          "ptr": {
            "$ref": "#/components/schemas/PtrData"
          },
          "registry": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Rir"
              },
              {
                "type": "null"
              }
            ]
          },
          "rdap": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RdapData"
              },
              {
                "type": "null"
              }
            ]
          },
          "rdap_checked": {
            "type": "boolean",
            "title": "Rdap Checked"
          },
          "route": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RouteData"
              },
              {
                "type": "null"
              }
            ]
          },
          "allocation": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/AllocationData"
              },
              {
                "type": "null"
              }
            ]
          },
          "routing_checked": {
            "type": "boolean",
            "title": "Routing Checked"
          },
          "table": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TableData"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "address",
          "version",
          "scope",
          "ptr",
          "registry",
          "rdap",
          "rdap_checked",
          "route",
          "allocation",
          "routing_checked",
          "table"
        ],
        "title": "IpLookupData",
        "description": "Reverse DNS with forward confirmation, the announcing network (origin AS, prefix, MOAS) and the allocating registry of a public IP address."
      },
      "IpLookupResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/IpLookupData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "IpLookupResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "Ipv6Host": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "role": {
            "$ref": "#/components/schemas/Role"
          },
          "ipv4": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Ipv4"
          },
          "ipv6": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Ipv6"
          },
          "ipv6_kinds": {
            "additionalProperties": {
              "$ref": "#/components/schemas/Kind"
            },
            "type": "object",
            "title": "Ipv6 Kinds"
          },
          "probe": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/WebProbe"
              },
              {
                "type": "null"
              }
            ]
          },
          "ns_probes": {
            "items": {
              "$ref": "#/components/schemas/NsProbe"
            },
            "type": "array",
            "title": "Ns Probes"
          }
        },
        "type": "object",
        "required": [
          "name",
          "role",
          "ipv4",
          "ipv6",
          "ipv6_kinds",
          "probe",
          "ns_probes"
        ],
        "title": "Ipv6Host"
      },
      "Ipv6TestData": {
        "properties": {
          "domain": {
            "type": "string",
            "title": "Domain"
          },
          "readiness": {
            "type": "string",
            "enum": [
              "full",
              "partial",
              "none"
            ],
            "title": "Readiness"
          },
          "grade_basis": {
            "type": "string",
            "enum": [
              "probes",
              "dns"
            ],
            "title": "Grade Basis"
          },
          "probes": {
            "type": "string",
            "enum": [
              "checked",
              "not_checked"
            ],
            "title": "Probes"
          },
          "hosts": {
            "items": {
              "$ref": "#/components/schemas/Ipv6Host"
            },
            "type": "array",
            "title": "Hosts"
          }
        },
        "type": "object",
        "required": [
          "domain",
          "readiness",
          "grade_basis",
          "probes",
          "hosts"
        ],
        "title": "Ipv6TestData",
        "description": "IPv6 readiness of a domain's website, mail servers and nameservers: AAAA records and, when our IPv6 connection is up, probes over IPv4 and IPv6."
      },
      "Ipv6TestResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/Ipv6TestData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "Ipv6TestResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "ItemStatusValue": {
        "type": "string",
        "enum": [
          "queued",
          "done",
          "failed",
          "skipped"
        ]
      },
      "JobItemError": {
        "properties": {
          "code": {
            "type": "string",
            "title": "Code"
          },
          "message": {
            "type": "string",
            "title": "Message"
          }
        },
        "type": "object",
        "required": [
          "code",
          "message"
        ],
        "title": "JobItemError"
      },
      "JobItemResponse": {
        "properties": {
          "row": {
            "type": "integer",
            "title": "Row",
            "description": "Row number, starting at 1"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/ItemStatusValue"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached"
          },
          "credits": {
            "type": "integer",
            "title": "Credits"
          },
          "error": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/JobItemError"
              },
              {
                "type": "null"
              }
            ]
          },
          "result": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ResultEnvelope"
              },
              {
                "type": "null"
              }
            ],
            "description": "The row's result envelope; null until it is done, and after 7 days"
          }
        },
        "type": "object",
        "required": [
          "row",
          "target",
          "status",
          "cached",
          "credits",
          "error",
          "result"
        ],
        "title": "JobItemResponse"
      },
      "JobItemsResponse": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/JobItemResponse"
            },
            "type": "array",
            "title": "Items"
          },
          "next_after": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next After",
            "description": "Pass as `after` for the next page; null on the last page"
          }
        },
        "type": "object",
        "required": [
          "items",
          "next_after"
        ],
        "title": "JobItemsResponse"
      },
      "JobResponse": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "status": {
            "$ref": "#/components/schemas/JobStatusValue"
          },
          "total": {
            "type": "integer",
            "title": "Total",
            "description": "Rows in the job"
          },
          "done": {
            "type": "integer",
            "title": "Done",
            "description": "Rows with a result (charged)"
          },
          "failed": {
            "type": "integer",
            "title": "Failed",
            "description": "Rows whose sources didn't answer (not charged)"
          },
          "credits_reserved": {
            "type": "integer",
            "title": "Credits Reserved",
            "description": "Credits held when the job was submitted"
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "Credits charged so far; the rest of the reservation returns when it ends"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          },
          "started_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Started At"
          },
          "finished_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Finished At"
          },
          "progress": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RowProgress"
              },
              {
                "type": "null"
              }
            ],
            "description": "The running row's own progress, such as pages crawled; null when none"
          },
          "label": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Label",
            "description": "The label given when it was submitted"
          },
          "bulk": {
            "type": "boolean",
            "title": "Bulk",
            "description": "True for a bulk check",
            "default": false
          },
          "estimated_remaining_s": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Estimated Remaining S",
            "description": "Seconds until the job should finish: from the rows done so far once 5 have finished, else from the estimate made at submission; null when finished or unknown"
          }
        },
        "type": "object",
        "required": [
          "id",
          "tool",
          "status",
          "total",
          "done",
          "failed",
          "credits_reserved",
          "credits_used",
          "created_at",
          "started_at",
          "finished_at"
        ],
        "title": "JobResponse"
      },
      "JobSource": {
        "properties": {
          "kind": {
            "type": "string",
            "const": "job",
            "title": "Kind"
          },
          "job_id": {
            "type": "string",
            "format": "uuid",
            "title": "Job Id",
            "description": "A job of this account (results kept 7 days)"
          },
          "row": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Row",
            "description": "One row (1-based); none = every row"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "kind",
          "job_id"
        ],
        "title": "JobSource"
      },
      "JobStartResponse": {
        "properties": {
          "job_id": {
            "type": "string",
            "format": "uuid",
            "title": "Job Id"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "total": {
            "type": "integer",
            "title": "Total"
          },
          "credits_reserved": {
            "type": "integer",
            "title": "Credits Reserved"
          },
          "duplicates_removed": {
            "type": "integer",
            "title": "Duplicates Removed",
            "default": 0
          },
          "job_url": {
            "type": "string",
            "title": "Job Url"
          },
          "items_url": {
            "type": "string",
            "title": "Items Url"
          },
          "events_url": {
            "type": "string",
            "title": "Events Url"
          }
        },
        "type": "object",
        "required": [
          "job_id",
          "status",
          "total",
          "credits_reserved",
          "job_url",
          "items_url",
          "events_url"
        ],
        "title": "JobStartResponse",
        "description": "202 body when a tool call starts a job (job tools, per-name calls above sync_max, bulk)."
      },
      "JobStatusValue": {
        "type": "string",
        "enum": [
          "queued",
          "running",
          "cancelling",
          "done",
          "cancelled",
          "failed"
        ]
      },
      "JobsKindFilter": {
        "type": "string",
        "enum": [
          "tool",
          "bulk",
          "all"
        ]
      },
      "JobsPage": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/JobResponse"
            },
            "type": "array",
            "title": "Items"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Cursor",
            "description": "Pass as `cursor` for the next page; null on the last page"
          }
        },
        "type": "object",
        "required": [
          "items",
          "next_cursor"
        ],
        "title": "JobsPage"
      },
      "JobsStatusFilter": {
        "type": "string",
        "enum": [
          "unfinished",
          "finished",
          "all"
        ]
      },
      "KeyDetails": {
        "properties": {
          "type": {
            "type": "string",
            "title": "Type"
          },
          "bits": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Bits"
          },
          "curve": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Curve"
          }
        },
        "type": "object",
        "required": [
          "type",
          "bits",
          "curve"
        ],
        "title": "KeyDetails"
      },
      "KeyInfo": {
        "properties": {
          "type": {
            "type": "string",
            "title": "Type"
          },
          "size": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Size"
          },
          "curve": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Curve"
          }
        },
        "type": "object",
        "required": [
          "type",
          "size",
          "curve"
        ],
        "title": "KeyInfo"
      },
      "KeyRow": {
        "properties": {
          "key_tag": {
            "type": "integer",
            "title": "Key Tag"
          },
          "role": {
            "type": "string",
            "enum": [
              "ksk",
              "zsk",
              "csk"
            ],
            "title": "Role"
          },
          "algorithm": {
            "type": "integer",
            "title": "Algorithm"
          },
          "algorithm_name": {
            "type": "string",
            "title": "Algorithm Name"
          },
          "bits": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Bits"
          },
          "revoked": {
            "type": "boolean",
            "title": "Revoked"
          },
          "servers": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Servers",
            "description": "Addresses that served this key"
          }
        },
        "type": "object",
        "required": [
          "key_tag",
          "role",
          "algorithm",
          "algorithm_name",
          "revoked",
          "servers"
        ],
        "title": "KeyRow"
      },
      "Kind": {
        "type": "string",
        "enum": [
          "public",
          "non_public",
          "transition"
        ]
      },
      "Limits": {
        "properties": {
          "plan": {
            "type": "string",
            "title": "Plan"
          },
          "monitors": {
            "$ref": "#/components/schemas/Usage"
          },
          "lookalike_domains": {
            "$ref": "#/components/schemas/Usage"
          },
          "kinds": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Kinds"
          },
          "min_interval": {
            "additionalProperties": {
              "type": "integer"
            },
            "type": "object",
            "title": "Min Interval"
          },
          "channels": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Channels"
          }
        },
        "type": "object",
        "required": [
          "plan",
          "monitors",
          "lookalike_domains",
          "kinds",
          "min_interval",
          "channels"
        ],
        "title": "Limits"
      },
      "LlmsTxt": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "present": {
            "type": "boolean",
            "title": "Present"
          },
          "status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "starts_with_h1": {
            "type": "boolean",
            "title": "Starts With H1"
          },
          "bytes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Bytes"
          }
        },
        "type": "object",
        "required": [
          "url",
          "present",
          "status",
          "starts_with_h1",
          "bytes"
        ],
        "title": "LlmsTxt"
      },
      "LogoOut": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "source": {
            "type": "string",
            "title": "Source"
          },
          "format": {
            "type": "string",
            "title": "Format"
          },
          "width": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Width"
          },
          "height": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Height"
          },
          "fallback": {
            "type": "boolean",
            "title": "Fallback"
          },
          "png_256": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Png 256"
          },
          "png_128": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Png 128"
          },
          "svg": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Svg"
          },
          "svg_removed": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Svg Removed"
          }
        },
        "type": "object",
        "required": [
          "url",
          "source",
          "format",
          "width",
          "height",
          "fallback",
          "png_256",
          "png_128",
          "svg",
          "svg_removed"
        ],
        "title": "LogoOut"
      },
      "LookalikeDomainsData": {
        "properties": {
          "mode": {
            "type": "string",
            "enum": [
              "generate",
              "check"
            ],
            "title": "Mode"
          },
          "domain": {
            "type": "string",
            "title": "Domain"
          },
          "unicode": {
            "type": "string",
            "title": "Unicode"
          },
          "reduced_from": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reduced From"
          },
          "generated": {
            "type": "integer",
            "title": "Generated"
          },
          "max_checks": {
            "type": "integer",
            "title": "Max Checks"
          },
          "checked": {
            "type": "integer",
            "title": "Checked",
            "default": 0
          },
          "not_reached": {
            "type": "integer",
            "title": "Not Reached",
            "default": 0
          },
          "by_kind": {
            "additionalProperties": {
              "type": "integer"
            },
            "type": "object",
            "title": "By Kind"
          },
          "variants": {
            "items": {
              "$ref": "#/components/schemas/LookalikeVariantData"
            },
            "type": "array",
            "title": "Variants"
          },
          "registered": {
            "items": {
              "$ref": "#/components/schemas/RegisteredVariantData"
            },
            "type": "array",
            "title": "Registered"
          },
          "no_dns": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "No Dns"
          },
          "unknown": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Unknown"
          },
          "whois_looked_up": {
            "type": "integer",
            "title": "Whois Looked Up",
            "default": 0
          },
          "whois_skipped": {
            "type": "integer",
            "title": "Whois Skipped",
            "default": 0
          },
          "titles_fetched": {
            "type": "integer",
            "title": "Titles Fetched",
            "default": 0
          },
          "price_to_check": {
            "type": "integer",
            "title": "Price To Check",
            "default": 0
          }
        },
        "type": "object",
        "required": [
          "mode",
          "domain",
          "unicode",
          "generated",
          "max_checks"
        ],
        "title": "LookalikeDomainsData",
        "description": "`data` of a lookalike-domains envelope: the generated variants (free) or the check's verdicts."
      },
      "LookalikeDomainsParams": {
        "properties": {
          "domain": {
            "type": "string",
            "maxLength": 2048,
            "minLength": 1,
            "title": "Domain",
            "description": "Your domain; reduced to its registrable part.",
            "examples": [
              "example.com"
            ]
          },
          "typos": {
            "type": "boolean",
            "title": "Typos",
            "description": "Missing, doubled, swapped and extra letters, keyboard slips, vowel swaps, hyphens and dots.",
            "default": true
          },
          "homoglyphs": {
            "type": "boolean",
            "title": "Homoglyphs",
            "description": "Characters that look like yours: rn for m, accented, Cyrillic and Greek letters.",
            "default": true
          },
          "tld_swaps": {
            "type": "boolean",
            "title": "Tld Swaps",
            "description": "The same name under other endings, such as .co or .net.",
            "default": true
          },
          "bitsquatting": {
            "type": "boolean",
            "title": "Bitsquatting",
            "description": "One-bit flips of a letter (memory errors).",
            "default": true
          },
          "max_checks": {
            "type": "integer",
            "maximum": 500,
            "minimum": 10,
            "title": "Max Checks",
            "description": "Check at most this many variants, the most similar first. 1 credit per 10.",
            "default": 200
          },
          "check": {
            "type": "boolean",
            "title": "Check",
            "description": "Check which variants are registered. Runs as a job; 1 credit per 10 checked.",
            "default": false
          },
          "fresh": {
            "type": "boolean",
            "title": "Fresh",
            "description": "Skip the cache and ask again; costs the same.",
            "default": false
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "domain"
        ],
        "title": "LookalikeDomainsParams"
      },
      "LookalikeDomainsResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/LookalikeDomainsData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "LookalikeDomainsResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "LookalikeVariantData": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "unicode": {
            "type": "string",
            "title": "Unicode"
          },
          "host": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Host"
          },
          "kind": {
            "type": "string",
            "enum": [
              "omission",
              "repetition",
              "transposition",
              "adjacent_key",
              "insertion",
              "vowel_swap",
              "bitsquatting",
              "hyphenation",
              "dot_insertion",
              "ascii_lookalike",
              "homoglyph",
              "whole_script",
              "tld_swap"
            ],
            "title": "Kind"
          },
          "similarity": {
            "type": "integer",
            "title": "Similarity"
          },
          "changed": {
            "items": {
              "type": "integer"
            },
            "type": "array",
            "title": "Changed"
          }
        },
        "type": "object",
        "required": [
          "name",
          "unicode",
          "kind",
          "similarity"
        ],
        "title": "LookalikeVariantData"
      },
      "MethodData": {
        "properties": {
          "result": {
            "type": "string",
            "title": "Result"
          },
          "domain": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Domain"
          },
          "selector": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Selector"
          }
        },
        "type": "object",
        "required": [
          "result",
          "domain",
          "selector"
        ],
        "title": "MethodData"
      },
      "Monitor": {
        "properties": {
          "id": {
            "type": "string",
            "format": "uuid",
            "title": "Id"
          },
          "kind": {
            "type": "string",
            "title": "Kind"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "label": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Label"
          },
          "interval": {
            "type": "integer",
            "title": "Interval"
          },
          "options": {
            "additionalProperties": true,
            "type": "object",
            "title": "Options"
          },
          "rules": {
            "additionalProperties": true,
            "type": "object",
            "title": "Rules"
          },
          "paused": {
            "type": "boolean",
            "title": "Paused"
          },
          "limited": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Limited",
            "description": "plan_kind or plan_count when your plan pauses it"
          },
          "limited_note": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Limited Note"
          },
          "health": {
            "type": "string",
            "enum": [
              "ok",
              "warn",
              "fail",
              "unknown"
            ],
            "title": "Health"
          },
          "pending_confirmation": {
            "type": "boolean",
            "title": "Pending Confirmation"
          },
          "last_run_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Run At"
          },
          "next_run_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Run At"
          },
          "last_event": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Event"
              },
              {
                "type": "null"
              }
            ]
          },
          "channel_ids": {
            "items": {
              "type": "string",
              "format": "uuid"
            },
            "type": "array",
            "title": "Channel Ids"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          }
        },
        "type": "object",
        "required": [
          "id",
          "kind",
          "target",
          "label",
          "interval",
          "options",
          "rules",
          "paused",
          "limited",
          "limited_note",
          "health",
          "pending_confirmation",
          "last_run_at",
          "next_run_at",
          "last_event",
          "channel_ids",
          "created_at"
        ],
        "title": "Monitor"
      },
      "MonitorList": {
        "properties": {
          "monitors": {
            "items": {
              "$ref": "#/components/schemas/Monitor"
            },
            "type": "array",
            "title": "Monitors"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Cursor"
          },
          "limits": {
            "$ref": "#/components/schemas/Limits"
          }
        },
        "type": "object",
        "required": [
          "monitors",
          "next_cursor",
          "limits"
        ],
        "title": "MonitorList"
      },
      "MonitorSource": {
        "properties": {
          "kind": {
            "type": "string",
            "const": "monitor",
            "title": "Kind"
          },
          "monitor_id": {
            "type": "string",
            "format": "uuid",
            "title": "Monitor Id"
          },
          "since": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "title": "Since"
          },
          "until": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "title": "Until"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "kind",
          "monitor_id"
        ],
        "title": "MonitorSource"
      },
      "MtaStsCheckerData": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "unicode": {
            "type": "string",
            "title": "Unicode"
          },
          "nxdomain": {
            "type": "boolean",
            "title": "Nxdomain"
          },
          "mx_hosts": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Mx Hosts"
          },
          "mta_sts": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/MtaStsData"
              },
              {
                "type": "null"
              }
            ]
          },
          "tls_rpt": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TlsRptData"
              },
              {
                "type": "null"
              }
            ]
          },
          "bimi": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/BimiData"
              },
              {
                "type": "null"
              }
            ]
          },
          "min_ttl": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Min Ttl"
          }
        },
        "type": "object",
        "required": [
          "name",
          "unicode",
          "nxdomain",
          "mx_hosts"
        ],
        "title": "MtaStsCheckerData",
        "description": "MTA-STS policy and DNS record, TLS-RPT reporting addresses and BIMI logo and mark certificate facts for a domain's mail."
      },
      "MtaStsCheckerResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/MtaStsCheckerData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "MtaStsCheckerResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "MtaStsData": {
        "properties": {
          "verdict": {
            "type": "string",
            "enum": [
              "enforced",
              "testing",
              "off",
              "missing",
              "broken",
              "unknown"
            ],
            "title": "Verdict"
          },
          "record": {
            "$ref": "#/components/schemas/MtaStsRecordData"
          },
          "policy": {
            "$ref": "#/components/schemas/MtaStsPolicyData"
          },
          "mx": {
            "items": {
              "$ref": "#/components/schemas/MxMatchData"
            },
            "type": "array",
            "title": "Mx"
          },
          "null_mx": {
            "type": "boolean",
            "title": "Null Mx"
          },
          "mx_certificates": {
            "type": "string",
            "const": "not_checked",
            "title": "Mx Certificates",
            "default": "not_checked"
          }
        },
        "type": "object",
        "required": [
          "verdict",
          "record",
          "policy",
          "mx",
          "null_mx"
        ],
        "title": "MtaStsData"
      },
      "MtaStsPolicyData": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "fetched": {
            "type": "boolean",
            "title": "Fetched"
          },
          "status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "content_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Content Type"
          },
          "size_bytes": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Size Bytes"
          },
          "problem": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PolicyProblem"
              },
              {
                "type": "null"
              }
            ]
          },
          "cert_problem": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CertProblem"
              },
              {
                "type": "null"
              }
            ]
          },
          "version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Version"
          },
          "mode": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "enforce",
                  "testing",
                  "none"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Mode"
          },
          "max_age": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Max Age"
          },
          "mx_patterns": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Mx Patterns"
          },
          "errors": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Errors"
          }
        },
        "type": "object",
        "required": [
          "url",
          "fetched",
          "status",
          "content_type",
          "size_bytes",
          "problem",
          "cert_problem",
          "version",
          "mode",
          "max_age",
          "mx_patterns",
          "errors"
        ],
        "title": "MtaStsPolicyData"
      },
      "MtaStsRecordData": {
        "properties": {
          "present": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Present"
          },
          "records": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Records"
          },
          "id": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Id"
          },
          "errors": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Errors"
          }
        },
        "type": "object",
        "required": [
          "present",
          "records",
          "id",
          "errors"
        ],
        "title": "MtaStsRecordData"
      },
      "MxData": {
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "found",
              "null",
              "missing",
              "failed"
            ],
            "title": "Status"
          },
          "null_mx": {
            "type": "boolean",
            "title": "Null Mx"
          },
          "implicit": {
            "type": "boolean",
            "title": "Implicit"
          },
          "records": {
            "items": {
              "$ref": "#/components/schemas/MxRecordData"
            },
            "type": "array",
            "title": "Records"
          }
        },
        "type": "object",
        "required": [
          "status",
          "null_mx",
          "implicit",
          "records"
        ],
        "title": "MxData"
      },
      "MxMatchData": {
        "properties": {
          "host": {
            "type": "string",
            "title": "Host"
          },
          "pattern": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Pattern"
          }
        },
        "type": "object",
        "required": [
          "host",
          "pattern"
        ],
        "title": "MxMatchData"
      },
      "MxRecordData": {
        "properties": {
          "preference": {
            "type": "integer",
            "title": "Preference"
          },
          "host": {
            "type": "string",
            "title": "Host"
          },
          "ttl": {
            "type": "integer",
            "title": "Ttl"
          },
          "is_ip": {
            "type": "boolean",
            "title": "Is Ip"
          },
          "cname": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Cname"
          },
          "A": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "A"
          },
          "AAAA": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Aaaa"
          },
          "status": {
            "type": "string",
            "title": "Status"
          },
          "provider": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Provider"
          }
        },
        "type": "object",
        "required": [
          "preference",
          "host",
          "ttl",
          "is_ip",
          "cname",
          "A",
          "AAAA",
          "status",
          "provider"
        ],
        "title": "MxRecordData"
      },
      "Names": {
        "properties": {
          "dns": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Dns",
            "default": []
          },
          "ip": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Ip",
            "default": []
          },
          "email": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Email",
            "default": []
          },
          "uri": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Uri",
            "default": []
          }
        },
        "type": "object",
        "title": "Names"
      },
      "NameserverRow": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "in_parent": {
            "type": "boolean",
            "title": "In Parent"
          },
          "in_child": {
            "type": "boolean",
            "title": "In Child"
          },
          "glue": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Glue"
          },
          "addresses": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Addresses"
          },
          "status": {
            "type": "string",
            "enum": [
              "ok",
              "lame",
              "unreachable",
              "no_address",
              "untested"
            ],
            "title": "Status"
          },
          "servers": {
            "items": {
              "$ref": "#/components/schemas/ServerRow"
            },
            "type": "array",
            "title": "Servers"
          }
        },
        "type": "object",
        "required": [
          "name",
          "in_parent",
          "in_child",
          "glue",
          "addresses",
          "status",
          "servers"
        ],
        "title": "NameserverRow"
      },
      "NetworkData": {
        "properties": {
          "asn": {
            "type": "integer",
            "title": "Asn"
          },
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "country": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Country"
          }
        },
        "type": "object",
        "required": [
          "asn",
          "name",
          "country"
        ],
        "title": "NetworkData"
      },
      "NsProbe": {
        "properties": {
          "address": {
            "type": "string",
            "title": "Address"
          },
          "answered": {
            "type": "boolean",
            "title": "Answered"
          },
          "authoritative": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Authoritative"
          },
          "serial": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Serial"
          },
          "ms": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ms"
          }
        },
        "type": "object",
        "required": [
          "address",
          "answered",
          "authoritative",
          "serial",
          "ms"
        ],
        "title": "NsProbe"
      },
      "OcspInfo": {
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "good",
              "revoked",
              "unknown"
            ],
            "title": "Status"
          },
          "produced_at": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Produced At"
          },
          "next_update": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Update"
          }
        },
        "type": "object",
        "required": [
          "status",
          "produced_at",
          "next_update"
        ],
        "title": "OcspInfo"
      },
      "Policies": {
        "properties": {
          "oids": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Oids"
          },
          "validation": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "dv",
                  "ov",
                  "ev"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Validation"
          }
        },
        "type": "object",
        "required": [
          "oids",
          "validation"
        ],
        "title": "Policies"
      },
      "PoliciesData": {
        "properties": {
          "checked": {
            "type": "boolean",
            "title": "Checked",
            "default": false
          },
          "mta_sts": {
            "$ref": "#/components/schemas/PolicySummary"
          },
          "tls_rpt": {
            "$ref": "#/components/schemas/PolicySummary"
          },
          "bimi": {
            "$ref": "#/components/schemas/PolicySummary"
          }
        },
        "type": "object",
        "required": [
          "mta_sts",
          "tls_rpt",
          "bimi"
        ],
        "title": "PoliciesData"
      },
      "PolicyProblem": {
        "type": "string",
        "enum": [
          "redirect",
          "http_status",
          "unreachable",
          "cert",
          "too_large",
          "timeout",
          "not_checked"
        ]
      },
      "PolicySummary": {
        "properties": {
          "present": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Present"
          },
          "record": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Record"
          },
          "verdict": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Verdict"
          },
          "headline": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Headline"
          },
          "checked": {
            "type": "boolean",
            "title": "Checked",
            "default": false
          }
        },
        "type": "object",
        "required": [
          "present",
          "record"
        ],
        "title": "PolicySummary"
      },
      "Port": {
        "type": "string",
        "enum": [
          "80",
          "443"
        ]
      },
      "PortCell": {
        "properties": {
          "state": {
            "$ref": "#/components/schemas/State"
          },
          "ms": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ms"
          },
          "tls": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TlsCell"
              },
              {
                "type": "null"
              }
            ]
          },
          "http": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/HttpCell"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "state",
          "ms",
          "tls",
          "http"
        ],
        "title": "PortCell"
      },
      "PortCheckerData": {
        "properties": {
          "host": {
            "type": "string",
            "title": "Host"
          },
          "rows": {
            "items": {
              "$ref": "#/components/schemas/PortRow"
            },
            "type": "array",
            "title": "Rows"
          },
          "omitted": {
            "type": "integer",
            "title": "Omitted"
          },
          "ipv6_checked": {
            "type": "boolean",
            "title": "Ipv6 Checked"
          }
        },
        "type": "object",
        "required": [
          "host",
          "rows",
          "omitted",
          "ipv6_checked"
        ],
        "title": "PortCheckerData",
        "description": "Whether ports 80 and 443 answer on each of a domain's addresses, with the TLS handshake and HTTP redirect for open ports."
      },
      "PortCheckerResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/PortCheckerData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "PortCheckerResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "PortRow": {
        "properties": {
          "address": {
            "type": "string",
            "title": "Address"
          },
          "family": {
            "type": "integer",
            "enum": [
              4,
              6
            ],
            "title": "Family"
          },
          "ports": {
            "additionalProperties": {
              "$ref": "#/components/schemas/PortCell"
            },
            "propertyNames": {
              "$ref": "#/components/schemas/Port"
            },
            "type": "object",
            "title": "Ports"
          }
        },
        "type": "object",
        "required": [
          "address",
          "family",
          "ports"
        ],
        "title": "PortRow"
      },
      "PreloadCheck": {
        "properties": {
          "eligible": {
            "type": "boolean",
            "title": "Eligible"
          },
          "applicable": {
            "type": "boolean",
            "title": "Applicable"
          },
          "missing": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Missing"
          }
        },
        "type": "object",
        "required": [
          "eligible",
          "applicable",
          "missing"
        ],
        "title": "PreloadCheck"
      },
      "PreviewImage": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "info": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/ImageInfoOut"
              },
              {
                "type": "null"
              }
            ]
          },
          "https": {
            "type": "boolean",
            "title": "Https"
          },
          "absolute": {
            "type": "boolean",
            "title": "Absolute"
          },
          "preview": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Preview"
          },
          "ratio": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ratio"
          },
          "problem": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "unreachable",
                  "not_image",
                  "too_large",
                  "undecodable",
                  "refused",
                  "timeout"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Problem"
          }
        },
        "type": "object",
        "required": [
          "url",
          "status",
          "info",
          "https",
          "absolute",
          "preview",
          "ratio",
          "problem"
        ],
        "title": "PreviewImage"
      },
      "PreviewTags": {
        "properties": {
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "image": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Image"
          },
          "url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Url"
          },
          "type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Type"
          },
          "site_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Site Name"
          },
          "twitter_card": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Twitter Card"
          },
          "twitter_site": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Twitter Site"
          },
          "sources": {
            "additionalProperties": {
              "type": "string",
              "enum": [
                "twitter",
                "og",
                "html",
                "none"
              ]
            },
            "type": "object",
            "title": "Sources"
          }
        },
        "type": "object",
        "required": [
          "title",
          "description",
          "image",
          "url",
          "type",
          "site_name",
          "twitter_card",
          "twitter_site",
          "sources"
        ],
        "title": "PreviewTags"
      },
      "ProbeSide": {
        "properties": {
          "status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          },
          "ms": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ms"
          }
        },
        "type": "object",
        "required": [
          "status",
          "title",
          "error",
          "ms"
        ],
        "title": "ProbeSide"
      },
      "ProviderData": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "source": {
            "type": "string",
            "enum": [
              "mx",
              "spf"
            ],
            "title": "Source"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "source"
        ],
        "title": "ProviderData"
      },
      "PtrData": {
        "properties": {
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "forward_confirmed": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Forward Confirmed"
          },
          "status": {
            "type": "string",
            "enum": [
              "found",
              "missing",
              "failed"
            ],
            "title": "Status"
          }
        },
        "type": "object",
        "required": [
          "name",
          "forward_confirmed",
          "status"
        ],
        "title": "PtrData"
      },
      "PublicStatus": {
        "properties": {
          "generated_at": {
            "type": "string",
            "format": "date-time",
            "title": "Generated At"
          },
          "overall": {
            "$ref": "#/components/schemas/ComponentState"
          },
          "components": {
            "items": {
              "$ref": "#/components/schemas/StatusComponent"
            },
            "type": "array",
            "title": "Components"
          },
          "registration": {
            "$ref": "#/components/schemas/RegistrationHealth"
          },
          "incidents": {
            "$ref": "#/components/schemas/StatusIncidents"
          }
        },
        "type": "object",
        "required": [
          "generated_at",
          "overall",
          "components",
          "registration",
          "incidents"
        ],
        "title": "PublicStatus",
        "description": "The `GET /v1/status` body, also the fallback's `snapshot.json` (B7.5)."
      },
      "PunycodeConverterData": {
        "properties": {
          "input": {
            "type": "string",
            "title": "Input"
          },
          "direction": {
            "type": "string",
            "enum": [
              "to_ascii",
              "to_unicode",
              "ascii_only"
            ],
            "title": "Direction"
          },
          "ascii": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Ascii"
          },
          "unicode": {
            "type": "string",
            "title": "Unicode"
          },
          "valid": {
            "type": "boolean",
            "title": "Valid"
          },
          "labels": {
            "items": {
              "$ref": "#/components/schemas/IdnLabel"
            },
            "type": "array",
            "title": "Labels"
          },
          "skeleton": {
            "type": "string",
            "title": "Skeleton"
          },
          "imitates": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Imitates",
            "description": "The ASCII name this one can pass for, if any."
          },
          "transitional_ascii": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Transitional Ascii",
            "description": "What IDNA 2003 (transitional) software makes of the name, when it differs."
          },
          "display": {
            "$ref": "#/components/schemas/IdnDisplay"
          }
        },
        "type": "object",
        "required": [
          "input",
          "direction",
          "ascii",
          "unicode",
          "valid",
          "labels",
          "skeleton",
          "imitates",
          "transitional_ascii",
          "display"
        ],
        "title": "PunycodeConverterData",
        "description": "A domain converted between Unicode and punycode, label by label, with the scripts used, lookalike warnings and how browsers will likely show it."
      },
      "PunycodeConverterResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/PunycodeConverterData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "PunycodeConverterResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "RawRecord": {
        "properties": {
          "format": {
            "type": "string",
            "enum": [
              "rdap-json",
              "whois-text"
            ],
            "title": "Format"
          },
          "registry": {
            "title": "Registry"
          },
          "registrar": {
            "anyOf": [
              {},
              {
                "type": "null"
              }
            ],
            "title": "Registrar"
          },
          "scrubbed": {
            "type": "boolean",
            "title": "Scrubbed",
            "default": true
          }
        },
        "type": "object",
        "required": [
          "format",
          "registry"
        ],
        "title": "RawRecord"
      },
      "RdapData": {
        "properties": {
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "handle": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Handle"
          },
          "start": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Start"
          },
          "end": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "End"
          },
          "type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Type"
          },
          "country": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Country"
          },
          "org": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Org"
          },
          "abuse_email": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Abuse Email"
          }
        },
        "type": "object",
        "required": [
          "name",
          "handle",
          "start",
          "end",
          "type",
          "country",
          "org",
          "abuse_email"
        ],
        "title": "RdapData"
      },
      "RecipientView": {
        "properties": {
          "user_id": {
            "type": "string",
            "format": "uuid",
            "title": "User Id"
          },
          "email": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Email",
            "description": "null when the user is no longer a member"
          }
        },
        "type": "object",
        "required": [
          "user_id",
          "email"
        ],
        "title": "RecipientView"
      },
      "RedirectCheckerData": {
        "properties": {
          "start_url": {
            "type": "string",
            "title": "Start Url"
          },
          "final_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Final Url"
          },
          "final_status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Final Status"
          },
          "hops": {
            "items": {
              "$ref": "#/components/schemas/RedirectHop"
            },
            "type": "array",
            "title": "Hops"
          },
          "stop": {
            "type": "string",
            "enum": [
              "final",
              "loop",
              "too_many",
              "refused",
              "error",
              "blocked"
            ],
            "title": "Stop"
          },
          "total_ms": {
            "type": "integer",
            "title": "Total Ms"
          },
          "cross_domain": {
            "type": "boolean",
            "title": "Cross Domain"
          },
          "shorteners": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Shorteners"
          },
          "clean_final_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Clean Final Url"
          },
          "removed_params": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Removed Params"
          }
        },
        "type": "object",
        "required": [
          "start_url",
          "final_url",
          "final_status",
          "hops",
          "stop",
          "total_ms",
          "cross_domain",
          "shorteners",
          "clean_final_url",
          "removed_params"
        ],
        "title": "RedirectCheckerData",
        "description": "Every hop of a URL's redirect chain, including meta refresh and literal JavaScript redirects, without running scripts."
      },
      "RedirectCheckerResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/RedirectCheckerData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "RedirectCheckerResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "RedirectHop": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "status": {
            "type": "integer",
            "title": "Status"
          },
          "location": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Location"
          },
          "elapsed_ms": {
            "type": "integer",
            "title": "Elapsed Ms"
          },
          "cookie_names": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Cookie Names"
          },
          "kind": {
            "type": "string",
            "enum": [
              "http",
              "meta-refresh",
              "js"
            ],
            "title": "Kind",
            "default": "http"
          },
          "address": {
            "type": "string",
            "title": "Address"
          },
          "same_site_as_start": {
            "type": "boolean",
            "title": "Same Site As Start"
          }
        },
        "type": "object",
        "required": [
          "url",
          "status",
          "location",
          "elapsed_ms",
          "cookie_names",
          "address",
          "same_site_as_start"
        ],
        "title": "RedirectHop"
      },
      "RegisteredVariantData": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "unicode": {
            "type": "string",
            "title": "Unicode"
          },
          "host": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Host"
          },
          "kind": {
            "type": "string",
            "enum": [
              "omission",
              "repetition",
              "transposition",
              "adjacent_key",
              "insertion",
              "vowel_swap",
              "bitsquatting",
              "hyphenation",
              "dot_insertion",
              "ascii_lookalike",
              "homoglyph",
              "whole_script",
              "tld_swap"
            ],
            "title": "Kind"
          },
          "similarity": {
            "type": "integer",
            "title": "Similarity"
          },
          "changed": {
            "items": {
              "type": "integer"
            },
            "type": "array",
            "title": "Changed"
          },
          "risk": {
            "type": "integer",
            "title": "Risk"
          },
          "risk_level": {
            "type": "string",
            "enum": [
              "high",
              "medium",
              "low"
            ],
            "title": "Risk Level"
          },
          "reasons": {
            "items": {
              "type": "string",
              "enum": [
                "new",
                "mail",
                "similar",
                "website"
              ]
            },
            "type": "array",
            "title": "Reasons"
          },
          "nameservers": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Nameservers"
          },
          "addresses": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Addresses"
          },
          "mx": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Mx"
          },
          "mail_capable": {
            "type": "boolean",
            "title": "Mail Capable",
            "default": false
          },
          "website": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Website"
              },
              {
                "type": "null"
              }
            ]
          },
          "created": {
            "anyOf": [
              {
                "type": "string",
                "format": "date"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created"
          },
          "age_days": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Age Days"
          },
          "registrar": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Registrar"
          },
          "created_source": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "rdap",
                  "whois"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Created Source"
          },
          "enrichment": {
            "type": "string",
            "enum": [
              "done",
              "skipped",
              "failed",
              "known"
            ],
            "title": "Enrichment",
            "default": "skipped"
          }
        },
        "type": "object",
        "required": [
          "name",
          "unicode",
          "kind",
          "similarity",
          "risk",
          "risk_level"
        ],
        "title": "RegisteredVariantData"
      },
      "Registrar": {
        "properties": {
          "name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "iana_id": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Iana Id"
          },
          "url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Url"
          },
          "abuse_email": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Abuse Email"
          },
          "abuse_phone": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Abuse Phone"
          }
        },
        "type": "object",
        "title": "Registrar"
      },
      "RegistrationHealth": {
        "properties": {
          "checked_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Checked At"
          },
          "tlds_total": {
            "type": "integer",
            "title": "Tlds Total",
            "default": 0
          },
          "tlds_ok": {
            "type": "integer",
            "title": "Tlds Ok",
            "default": 0
          },
          "failing_tlds": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Failing Tlds"
          }
        },
        "type": "object",
        "title": "RegistrationHealth"
      },
      "ReportAuthorization": {
        "properties": {
          "domain": {
            "type": "string",
            "title": "Domain"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "value": {
            "type": "string",
            "title": "Value"
          }
        },
        "type": "object",
        "required": [
          "domain",
          "name",
          "value"
        ],
        "title": "ReportAuthorization"
      },
      "RestrictionLevel": {
        "type": "string",
        "enum": [
          "ascii",
          "single_script",
          "highly_restrictive",
          "moderately_restrictive",
          "minimally_restrictive"
        ]
      },
      "ResultEnvelope": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "additionalProperties": true,
            "type": "object",
            "title": "Data"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary"
        ],
        "title": "ResultEnvelope"
      },
      "Rir": {
        "type": "string",
        "enum": [
          "arin",
          "ripe",
          "apnic",
          "lacnic",
          "afrinic"
        ]
      },
      "Role": {
        "type": "string",
        "enum": [
          "web",
          "www",
          "mx",
          "ns"
        ]
      },
      "RouteData": {
        "properties": {
          "prefix": {
            "type": "string",
            "title": "Prefix"
          },
          "origins": {
            "items": {
              "$ref": "#/components/schemas/AsnData"
            },
            "type": "array",
            "title": "Origins"
          },
          "moas": {
            "type": "boolean",
            "title": "Moas"
          },
          "peers": {
            "type": "integer",
            "title": "Peers"
          },
          "covering": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Covering"
          }
        },
        "type": "object",
        "required": [
          "prefix",
          "origins",
          "moas",
          "peers",
          "covering"
        ],
        "title": "RouteData"
      },
      "RowProgress": {
        "properties": {
          "stage": {
            "type": "string",
            "title": "Stage"
          },
          "done": {
            "type": "integer",
            "title": "Done"
          },
          "total": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Total"
          }
        },
        "type": "object",
        "required": [
          "stage",
          "done",
          "total"
        ],
        "title": "RowProgress",
        "description": "What the running row reported last (a crawl's pages, for example)."
      },
      "Rules": {
        "properties": {
          "min_severity": {
            "type": "string",
            "enum": [
              "info",
              "warn",
              "fail"
            ],
            "title": "Min Severity",
            "description": "Alert only for events at or above this severity",
            "default": "info"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "Rules"
      },
      "Sct": {
        "properties": {
          "log_id": {
            "type": "string",
            "title": "Log Id"
          },
          "timestamp": {
            "type": "string",
            "title": "Timestamp"
          }
        },
        "type": "object",
        "required": [
          "log_id",
          "timestamp"
        ],
        "title": "Sct"
      },
      "SecretRotated": {
        "properties": {
          "signing_secret": {
            "type": "string",
            "title": "Signing Secret"
          }
        },
        "type": "object",
        "required": [
          "signing_secret"
        ],
        "title": "SecretRotated"
      },
      "SecurityHeadersData": {
        "properties": {
          "host": {
            "type": "string",
            "title": "Host"
          },
          "alternate_host": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Alternate Host"
          },
          "reachable": {
            "type": "boolean",
            "title": "Reachable"
          },
          "no_website": {
            "type": "boolean",
            "title": "No Website",
            "default": false
          },
          "entry_points": {
            "items": {
              "$ref": "#/components/schemas/EntryPoint"
            },
            "type": "array",
            "title": "Entry Points"
          },
          "primary_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Primary Url"
          },
          "primary_status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Primary Status"
          },
          "http_version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Http Version"
          },
          "headers": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "title": "Headers"
          },
          "hsts": {
            "$ref": "#/components/schemas/HstsInfo"
          },
          "preload": {
            "$ref": "#/components/schemas/PreloadCheck"
          },
          "csp": {
            "items": {
              "$ref": "#/components/schemas/CspPolicy"
            },
            "type": "array",
            "title": "Csp"
          },
          "framing": {
            "type": "string",
            "enum": [
              "frame-ancestors",
              "x-frame-options",
              "none"
            ],
            "title": "Framing"
          },
          "referrer_policy": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Referrer Policy"
          },
          "permissions_policy": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Permissions Policy"
          },
          "coop": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Coop"
          },
          "coep": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Coep"
          },
          "corp": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Corp"
          },
          "cookies": {
            "items": {
              "$ref": "#/components/schemas/CookieInfo"
            },
            "type": "array",
            "title": "Cookies"
          },
          "disclosed": {
            "items": {
              "$ref": "#/components/schemas/Disclosure"
            },
            "type": "array",
            "title": "Disclosed"
          },
          "http2": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Http2"
          },
          "http3_advertised": {
            "type": "boolean",
            "title": "Http3 Advertised"
          }
        },
        "type": "object",
        "required": [
          "host",
          "alternate_host",
          "reachable",
          "entry_points",
          "primary_url",
          "primary_status",
          "http_version",
          "headers",
          "hsts",
          "preload",
          "csp",
          "framing",
          "referrer_policy",
          "permissions_policy",
          "coop",
          "coep",
          "corp",
          "cookies",
          "disclosed",
          "http2",
          "http3_advertised"
        ],
        "title": "SecurityHeadersData",
        "description": "How a site answers on http and https with and without www, its redirects, security headers, HSTS, CSP and cookies, graded."
      },
      "SecurityHeadersResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/SecurityHeadersData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "SecurityHeadersResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "SecurityTxt": {
        "properties": {
          "url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Url"
          },
          "location": {
            "type": "string",
            "enum": [
              "well-known",
              "legacy",
              "none"
            ],
            "title": "Location"
          },
          "status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "content_type": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Content Type"
          },
          "https": {
            "type": "boolean",
            "title": "Https"
          },
          "signed": {
            "type": "boolean",
            "title": "Signed"
          },
          "verified": {
            "type": "null",
            "title": "Verified"
          },
          "fields": {
            "additionalProperties": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "type": "object",
            "title": "Fields"
          },
          "expires": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expires"
          },
          "expires_in_days": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expires In Days"
          },
          "invalid_lines": {
            "items": {
              "type": "integer"
            },
            "type": "array",
            "title": "Invalid Lines"
          }
        },
        "type": "object",
        "required": [
          "url",
          "location",
          "status",
          "content_type",
          "https",
          "signed",
          "fields",
          "expires",
          "expires_in_days",
          "invalid_lines"
        ],
        "title": "SecurityTxt"
      },
      "SecurityTxtCheckerData": {
        "properties": {
          "host": {
            "type": "string",
            "title": "Host"
          },
          "security_txt": {
            "$ref": "#/components/schemas/SecurityTxt"
          },
          "ads_txt": {
            "$ref": "#/components/schemas/AdsFile"
          },
          "app_ads_txt": {
            "$ref": "#/components/schemas/AdsFile"
          },
          "humans_txt": {
            "type": "boolean",
            "title": "Humans Txt"
          },
          "page_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Page Url"
          },
          "mixed_content": {
            "items": {
              "additionalProperties": {
                "type": "string"
              },
              "type": "object"
            },
            "type": "array",
            "title": "Mixed Content"
          },
          "compression": {
            "items": {
              "$ref": "#/components/schemas/AssetCache"
            },
            "type": "array",
            "title": "Compression"
          },
          "caching": {
            "items": {
              "$ref": "#/components/schemas/AssetCache"
            },
            "type": "array",
            "title": "Caching"
          }
        },
        "type": "object",
        "required": [
          "host",
          "security_txt",
          "ads_txt",
          "app_ads_txt",
          "humans_txt",
          "page_url",
          "mixed_content",
          "compression",
          "caching"
        ],
        "title": "SecurityTxtCheckerData",
        "description": "A site's security.txt, ads.txt, app-ads.txt and humans.txt, mixed content, compression and caching headers."
      },
      "SecurityTxtCheckerResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/SecurityTxtCheckerData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "SecurityTxtCheckerResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "SeoAuditData": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "final_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Final Url"
          },
          "status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "hops": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array",
            "title": "Hops"
          },
          "html_bytes": {
            "type": "integer",
            "title": "Html Bytes"
          },
          "truncated": {
            "type": "boolean",
            "title": "Truncated"
          },
          "elapsed_ms": {
            "type": "integer",
            "title": "Elapsed Ms"
          },
          "indexability": {
            "additionalProperties": true,
            "type": "object",
            "title": "Indexability"
          },
          "canonical": {
            "additionalProperties": true,
            "type": "object",
            "title": "Canonical"
          },
          "content": {
            "additionalProperties": true,
            "type": "object",
            "title": "Content"
          },
          "links": {
            "additionalProperties": {
              "type": "integer"
            },
            "type": "object",
            "title": "Links"
          },
          "sitemap": {
            "additionalProperties": true,
            "type": "object",
            "title": "Sitemap"
          },
          "presence": {
            "additionalProperties": {
              "type": "boolean"
            },
            "type": "object",
            "title": "Presence"
          },
          "redirects": {
            "additionalProperties": true,
            "type": "object",
            "title": "Redirects"
          },
          "js": {
            "additionalProperties": true,
            "type": "object",
            "title": "Js"
          },
          "rendered": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Rendered"
          }
        },
        "type": "object",
        "required": [
          "url",
          "final_url",
          "status",
          "hops",
          "html_bytes",
          "truncated",
          "elapsed_ms",
          "indexability",
          "canonical",
          "content",
          "links",
          "sitemap",
          "presence",
          "redirects",
          "js",
          "rendered"
        ],
        "title": "SeoAuditData",
        "description": "Indexability, canonical, content, links, sitemap and redirects of a page, graded; optionally compared with the rendered page."
      },
      "SeoAuditParams": {
        "properties": {
          "url": {
            "type": "string",
            "maxLength": 2048,
            "minLength": 1,
            "title": "Url",
            "description": "A page URL or a domain; a domain means its home page.",
            "examples": [
              "example.com"
            ],
            "x-mono": true,
            "x-widget": "url"
          },
          "rendered": {
            "type": "boolean",
            "title": "Render JavaScript first",
            "description": "Load the page in a headless browser and compare with the raw HTML. Costs 8 credits and runs as a job.",
            "default": false
          },
          "fresh": {
            "type": "boolean",
            "title": "Fresh",
            "description": "Skip the cache and ask the source again; costs the same.",
            "default": false
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "url"
        ],
        "title": "SeoAuditParams"
      },
      "SeoAuditResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/SeoAuditData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "SeoAuditResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "ServerRow": {
        "properties": {
          "address": {
            "type": "string",
            "title": "Address"
          },
          "family": {
            "type": "string",
            "enum": [
              "ipv4",
              "ipv6"
            ],
            "title": "Family"
          },
          "udp": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Udp"
          },
          "tcp": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Tcp"
          },
          "authoritative": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Authoritative"
          },
          "serial": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Serial"
          },
          "elapsed_ms": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Elapsed Ms"
          },
          "open_resolver": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Open Resolver"
          },
          "dnskey_tags": {
            "items": {
              "type": "integer"
            },
            "type": "array",
            "title": "Dnskey Tags"
          }
        },
        "type": "object",
        "required": [
          "address",
          "family"
        ],
        "title": "ServerRow"
      },
      "Severity": {
        "type": "string",
        "enum": [
          "pass",
          "info",
          "warn",
          "fail"
        ],
        "title": "Severity"
      },
      "Share": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "url": {
            "type": "string",
            "title": "Url"
          },
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "tool_name": {
            "type": "string",
            "title": "Tool Name"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "created_at": {
            "type": "string",
            "format": "date-time",
            "title": "Created At"
          },
          "expires_at": {
            "type": "string",
            "format": "date-time",
            "title": "Expires At"
          },
          "revoked_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Revoked At"
          },
          "has_password": {
            "type": "boolean",
            "title": "Has Password"
          },
          "views": {
            "type": "integer",
            "title": "Views"
          },
          "last_viewed_at": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Last Viewed At"
          },
          "state": {
            "type": "string",
            "enum": [
              "active",
              "expired",
              "revoked"
            ],
            "title": "State"
          }
        },
        "type": "object",
        "required": [
          "id",
          "url",
          "tool",
          "tool_name",
          "target",
          "fetched_at",
          "created_at",
          "expires_at",
          "revoked_at",
          "has_password",
          "views",
          "last_viewed_at",
          "state"
        ],
        "title": "Share"
      },
      "ShareList": {
        "properties": {
          "items": {
            "items": {
              "$ref": "#/components/schemas/Share"
            },
            "type": "array",
            "title": "Items"
          },
          "next_cursor": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Next Cursor",
            "description": "Pass as `cursor` for the next page; null at the end"
          }
        },
        "type": "object",
        "required": [
          "items",
          "next_cursor"
        ],
        "title": "ShareList"
      },
      "ShareSource": {
        "properties": {
          "request_id": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 128,
                "minLength": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Request Id",
            "description": "The X-Request-Id of the call whose result to share (kept 24 hours)"
          },
          "job_id": {
            "anyOf": [
              {
                "type": "string",
                "format": "uuid"
              },
              {
                "type": "null"
              }
            ],
            "title": "Job Id",
            "description": "A job of this account"
          },
          "row": {
            "type": "integer",
            "minimum": 0,
            "title": "Row",
            "description": "The job's row (1-based); 0 means the first row",
            "default": 0
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "ShareSource",
        "description": "Where the result comes from: a call's request id, or a job row."
      },
      "SignatureRow": {
        "properties": {
          "covers": {
            "type": "string",
            "title": "Covers"
          },
          "key_tag": {
            "type": "integer",
            "title": "Key Tag"
          },
          "expiration": {
            "type": "string",
            "title": "Expiration"
          },
          "expires_in_days": {
            "type": "integer",
            "title": "Expires In Days"
          },
          "state": {
            "type": "string",
            "enum": [
              "valid",
              "invalid",
              "expired",
              "not_yet_valid",
              "no_key",
              "unsupported_algorithm"
            ],
            "title": "State"
          },
          "servers": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Servers"
          }
        },
        "type": "object",
        "required": [
          "covers",
          "key_tag",
          "expiration",
          "expires_in_days",
          "state",
          "servers"
        ],
        "title": "SignatureRow"
      },
      "SocialPreviewData": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "final_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Final Url"
          },
          "og": {
            "additionalProperties": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "type": "object",
            "title": "Og"
          },
          "twitter": {
            "additionalProperties": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "type": "object",
            "title": "Twitter"
          },
          "resolved": {
            "$ref": "#/components/schemas/PreviewTags"
          },
          "image": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/PreviewImage"
              },
              {
                "type": "null"
              }
            ]
          },
          "platforms": {
            "items": {
              "type": "string",
              "enum": [
                "linkedin",
                "x",
                "facebook",
                "slack",
                "whatsapp"
              ]
            },
            "type": "array",
            "title": "Platforms"
          },
          "refresh_tools": {
            "additionalProperties": {
              "type": "string"
            },
            "type": "object",
            "title": "Refresh Tools"
          }
        },
        "type": "object",
        "required": [
          "url",
          "final_url",
          "og",
          "twitter",
          "resolved",
          "image",
          "platforms",
          "refresh_tools"
        ],
        "title": "SocialPreviewData",
        "description": "The Open Graph and X card tags of a page as platforms resolve them, and its preview image."
      },
      "SocialPreviewResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/SocialPreviewData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "SocialPreviewResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "SpfBuild": {
        "properties": {
          "lookups": {
            "type": "integer",
            "title": "Lookups"
          },
          "lookup_limit": {
            "type": "integer",
            "title": "Lookup Limit"
          },
          "void_lookups": {
            "type": "integer",
            "title": "Void Lookups"
          },
          "capped": {
            "type": "boolean",
            "title": "Capped"
          },
          "tree": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Tree"
          },
          "flattening": {
            "$ref": "#/components/schemas/SpfFlattening"
          }
        },
        "type": "object",
        "required": [
          "lookups",
          "lookup_limit",
          "void_lookups",
          "capped",
          "tree",
          "flattening"
        ],
        "title": "SpfBuild"
      },
      "SpfData": {
        "properties": {
          "status": {
            "type": "string",
            "enum": [
              "found",
              "missing",
              "multiple",
              "failed"
            ],
            "title": "Status"
          },
          "record": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Record"
          },
          "records": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Records"
          },
          "all": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "All"
          },
          "redirect": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Redirect"
          },
          "lookups": {
            "type": "integer",
            "title": "Lookups"
          },
          "lookup_limit": {
            "type": "integer",
            "title": "Lookup Limit"
          },
          "void_lookups": {
            "type": "integer",
            "title": "Void Lookups"
          },
          "capped": {
            "type": "boolean",
            "title": "Capped"
          },
          "receiver_result": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "permerror",
                  "temperror"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Receiver Result"
          },
          "tree": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Tree"
          }
        },
        "type": "object",
        "required": [
          "status",
          "record",
          "records",
          "all",
          "redirect",
          "lookups",
          "lookup_limit",
          "void_lookups",
          "capped",
          "receiver_result",
          "tree"
        ],
        "title": "SpfData"
      },
      "SpfFlattening": {
        "properties": {
          "needed": {
            "type": "boolean",
            "title": "Needed"
          },
          "advice": {
            "type": "string",
            "title": "Advice"
          }
        },
        "type": "object",
        "required": [
          "needed",
          "advice"
        ],
        "title": "SpfFlattening"
      },
      "SpfGeneratorData": {
        "properties": {
          "kind": {
            "type": "string",
            "enum": [
              "spf",
              "dmarc",
              "caa"
            ],
            "title": "Kind"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "type": {
            "type": "string",
            "enum": [
              "TXT",
              "CAA"
            ],
            "title": "Type"
          },
          "value": {
            "type": "string",
            "title": "Value"
          },
          "strings": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Strings"
          },
          "length": {
            "type": "integer",
            "title": "Length"
          },
          "zone_line": {
            "type": "string",
            "title": "Zone Line"
          },
          "mode": {
            "type": "string",
            "enum": [
              "build",
              "validate"
            ],
            "title": "Mode"
          },
          "spf": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/SpfBuild"
              },
              {
                "type": "null"
              }
            ]
          },
          "dmarc": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DmarcBuild"
              },
              {
                "type": "null"
              }
            ]
          },
          "caa": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CaaBuild"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "kind",
          "name",
          "type",
          "value",
          "strings",
          "length",
          "zone_line",
          "mode"
        ],
        "title": "SpfGeneratorData",
        "description": "An SPF record built from your senders, or a pasted record checked, with its DNS lookup count and the include tree."
      },
      "SpfGeneratorParams": {
        "properties": {
          "domain": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ],
            "title": "Domain",
            "description": "Your domain; needed for the mx and a mechanisms and to count lookups.",
            "examples": [
              "example.com"
            ]
          },
          "record": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ],
            "title": "Record",
            "description": "An existing SPF record to check instead of building one.",
            "x-mono": true,
            "x-widget": "textarea"
          },
          "providers": {
            "anyOf": [
              {
                "items": {
                  "type": "string",
                  "pattern": "^[a-z0-9-]{1,40}$"
                },
                "type": "array",
                "maxItems": 20
              },
              {
                "type": "null"
              }
            ],
            "uniqueItems": true,
            "title": "Providers",
            "description": "Mail services that send for your domain.",
            "x-widget": "checkboxes"
          },
          "includes": {
            "anyOf": [
              {
                "items": {
                  "type": "string",
                  "maxLength": 253
                },
                "type": "array",
                "maxItems": 10
              },
              {
                "type": "null"
              }
            ],
            "title": "Includes",
            "description": "Other include domains, one per line.",
            "x-widget": "lines"
          },
          "ip4": {
            "anyOf": [
              {
                "items": {
                  "type": "string",
                  "maxLength": 18
                },
                "type": "array",
                "maxItems": 50
              },
              {
                "type": "null"
              }
            ],
            "title": "Ip4",
            "description": "IPv4 addresses or ranges that send mail, one per line.",
            "x-widget": "lines"
          },
          "ip6": {
            "anyOf": [
              {
                "items": {
                  "type": "string",
                  "maxLength": 43
                },
                "type": "array",
                "maxItems": 50
              },
              {
                "type": "null"
              }
            ],
            "title": "Ip6",
            "description": "IPv6 addresses or ranges that send mail, one per line.",
            "x-widget": "lines"
          },
          "a": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "A",
            "description": "The domain's own web server sends mail."
          },
          "mx": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Mx",
            "description": "The domain's mail servers also send mail."
          },
          "all": {
            "type": "string",
            "enum": [
              "-all",
              "~all"
            ],
            "title": "All",
            "description": "What receivers do with mail from anyone else.",
            "default": "~all"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "SpfGeneratorParams"
      },
      "SpfGeneratorResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/SpfGeneratorData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "SpfGeneratorResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "SslCheckerData": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "unicode": {
            "type": "string",
            "title": "Unicode"
          },
          "hosts": {
            "items": {
              "$ref": "#/components/schemas/SslHost"
            },
            "type": "array",
            "title": "Hosts"
          },
          "trust_store": {
            "$ref": "#/components/schemas/TrustStoreInfo"
          },
          "legacy_versions_tested": {
            "type": "boolean",
            "title": "Legacy Versions Tested",
            "description": "Whether TLS 1.0 and 1.1 were probed."
          },
          "not_checked": {
            "anyOf": [
              {
                "type": "string",
                "const": "ipv6_only"
              },
              {
                "type": "null"
              }
            ],
            "title": "Not Checked"
          }
        },
        "type": "object",
        "required": [
          "name",
          "unicode",
          "hosts",
          "trust_store",
          "legacy_versions_tested"
        ],
        "title": "SslCheckerData",
        "description": "The certificate on port 443 for the domain and www: chain and trust, expiry, names covered, key and signature, TLS versions offered, and a grade."
      },
      "SslCheckerResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/SslCheckerData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "SslCheckerResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "SslHost": {
        "properties": {
          "host": {
            "type": "string",
            "title": "Host"
          },
          "status": {
            "$ref": "#/components/schemas/HostStatus"
          },
          "address": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Address"
          },
          "error": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/HostError"
              },
              {
                "type": "null"
              }
            ]
          },
          "tls": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TlsInfo"
              },
              {
                "type": "null"
              }
            ]
          },
          "certificate": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/CertificateInfo"
              },
              {
                "type": "null"
              }
            ]
          },
          "chain": {
            "items": {
              "$ref": "#/components/schemas/ChainCert"
            },
            "type": "array",
            "title": "Chain",
            "description": "The certificates as the server sent them."
          },
          "trust": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/TrustInfo"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "host",
          "status",
          "address",
          "error",
          "tls",
          "certificate",
          "chain",
          "trust"
        ],
        "title": "SslHost"
      },
      "State": {
        "type": "string",
        "enum": [
          "open",
          "closed",
          "filtered",
          "unreachable",
          "not_checked"
        ]
      },
      "StatusComponent": {
        "properties": {
          "id": {
            "$ref": "#/components/schemas/ComponentId"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "state": {
            "$ref": "#/components/schemas/ComponentState"
          },
          "since": {
            "anyOf": [
              {
                "type": "string",
                "format": "date-time"
              },
              {
                "type": "null"
              }
            ],
            "title": "Since"
          },
          "detail_code": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/DetailCode"
              },
              {
                "type": "null"
              }
            ]
          },
          "uptime_90d": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Uptime 90D",
            "description": "Percent of sampled minutes without an outage, last 90 days"
          },
          "days": {
            "items": {
              "$ref": "#/components/schemas/StatusDay"
            },
            "type": "array",
            "title": "Days"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "state"
        ],
        "title": "StatusComponent"
      },
      "StatusDay": {
        "properties": {
          "date": {
            "type": "string",
            "format": "date",
            "title": "Date"
          },
          "state": {
            "$ref": "#/components/schemas/DayState"
          },
          "ok_minutes": {
            "type": "integer",
            "minimum": 0,
            "title": "Ok Minutes"
          },
          "total_minutes": {
            "type": "integer",
            "minimum": 0,
            "title": "Total Minutes"
          }
        },
        "type": "object",
        "required": [
          "date",
          "state",
          "ok_minutes",
          "total_minutes"
        ],
        "title": "StatusDay"
      },
      "StatusIncidents": {
        "properties": {
          "open": {
            "items": {
              "$ref": "#/components/schemas/Incident"
            },
            "type": "array",
            "title": "Open"
          },
          "recent": {
            "items": {
              "$ref": "#/components/schemas/Incident"
            },
            "type": "array",
            "title": "Recent",
            "description": "Resolved in 14 days"
          }
        },
        "type": "object",
        "title": "StatusIncidents"
      },
      "Step": {
        "properties": {
          "method": {
            "type": "string",
            "title": "Method"
          },
          "server": {
            "type": "string",
            "title": "Server"
          },
          "result": {
            "type": "string",
            "title": "Result"
          },
          "elapsed_ms": {
            "type": "integer",
            "title": "Elapsed Ms"
          }
        },
        "type": "object",
        "required": [
          "method",
          "server",
          "result",
          "elapsed_ms"
        ],
        "title": "Step"
      },
      "StreamCreated": {
        "properties": {
          "stream_id": {
            "type": "string",
            "title": "Stream Id",
            "description": "Opaque id of the run's event stream"
          },
          "stream_url": {
            "type": "string",
            "title": "Stream Url",
            "description": "Open this for the events (GET, text/event-stream)"
          },
          "request_id": {
            "type": "string",
            "title": "Request Id",
            "description": "This call's request id, the ledger reference"
          },
          "free_checks_remaining": {
            "anyOf": [
              {
                "type": "integer",
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Free Checks Remaining",
            "description": "Website free checks only: how many free checks the visitor has left today, after this one. Absent for calls made with an account's key or session."
          }
        },
        "type": "object",
        "required": [
          "stream_id",
          "stream_url",
          "request_id"
        ],
        "title": "StreamCreated"
      },
      "StreamRequest": {
        "properties": {
          "tool": {
            "type": "string",
            "maxLength": 64,
            "title": "Tool",
            "description": "Registry id of the tool",
            "examples": [
              "dns-lookup"
            ]
          },
          "input": {
            "additionalProperties": true,
            "type": "object",
            "title": "Input",
            "description": "The tool's parameters, as for its own endpoint",
            "examples": [
              {
                "domain": "example.com",
                "types": "A,MX"
              }
            ]
          },
          "fresh": {
            "type": "boolean",
            "title": "Fresh",
            "description": "Skip the cache and ask the sources again",
            "default": false
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "tool"
        ],
        "title": "StreamRequest"
      },
      "StreamResult": {
        "properties": {
          "done": {
            "type": "boolean",
            "title": "Done",
            "description": "True when the last event is included"
          },
          "events": {
            "items": {
              "$ref": "#/components/schemas/StreamResultEvent"
            },
            "type": "array",
            "title": "Events"
          }
        },
        "type": "object",
        "required": [
          "done",
          "events"
        ],
        "title": "StreamResult"
      },
      "StreamResultEvent": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id",
            "description": "The event id (as the event stream's `id`)"
          },
          "event": {
            "type": "string",
            "title": "Event",
            "description": "`started`, `section`, `result` or `error`"
          },
          "data": {
            "additionalProperties": true,
            "type": "object",
            "title": "Data"
          }
        },
        "type": "object",
        "required": [
          "id",
          "event",
          "data"
        ],
        "title": "StreamResultEvent"
      },
      "StructuredDataValidatorData": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "final_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Final Url"
          },
          "status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "truncated": {
            "type": "boolean",
            "title": "Truncated"
          },
          "items": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array",
            "title": "Items"
          },
          "jsonld_errors": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array",
            "title": "Jsonld Errors"
          },
          "counts": {
            "additionalProperties": {
              "type": "integer"
            },
            "type": "object",
            "title": "Counts"
          },
          "hreflang": {
            "additionalProperties": true,
            "type": "object",
            "title": "Hreflang"
          }
        },
        "type": "object",
        "required": [
          "url",
          "final_url",
          "status",
          "truncated",
          "items",
          "jsonld_errors",
          "counts",
          "hreflang"
        ],
        "title": "StructuredDataValidatorData",
        "description": "JSON-LD, microdata and RDFa items on a page checked against schema.org rules, and hreflang alternates."
      },
      "StructuredDataValidatorResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/StructuredDataValidatorData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "StructuredDataValidatorResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "SubdomainTakeoverCheckParams": {
        "properties": {
          "names": {
            "items": {
              "type": "string",
              "maxLength": 253
            },
            "type": "array",
            "maxItems": 100,
            "minItems": 1,
            "title": "Names",
            "description": "The names to check, one per line, such as shop.example.com.",
            "x-widget": "lines"
          },
          "fresh": {
            "type": "boolean",
            "title": "Fresh",
            "description": "Skip the cache and ask the source again; costs the same.",
            "default": false
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "names"
        ],
        "title": "SubdomainTakeoverCheckParams"
      },
      "TableData": {
        "properties": {
          "built_at": {
            "type": "string",
            "title": "Built At"
          },
          "age_hours": {
            "type": "integer",
            "title": "Age Hours"
          }
        },
        "type": "object",
        "required": [
          "built_at",
          "age_hours"
        ],
        "title": "TableData"
      },
      "TechStackCheckerData": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "final_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Final Url"
          },
          "technologies": {
            "items": {
              "$ref": "#/components/schemas/Technology"
            },
            "type": "array",
            "title": "Technologies"
          },
          "by_category": {
            "additionalProperties": {
              "items": {
                "type": "string"
              },
              "type": "array"
            },
            "type": "object",
            "title": "By Category"
          },
          "catalog_size": {
            "type": "integer",
            "title": "Catalog Size"
          },
          "dns_checked": {
            "type": "boolean",
            "title": "Dns Checked"
          },
          "network": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/NetworkData"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "url",
          "final_url",
          "technologies",
          "by_category",
          "catalog_size",
          "dns_checked"
        ],
        "title": "TechStackCheckerData",
        "description": "Technologies a site uses, detected from headers, cookies, HTML and DNS, with the evidence."
      },
      "TechStackCheckerResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/TechStackCheckerData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "TechStackCheckerResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "Technology": {
        "properties": {
          "id": {
            "type": "string",
            "title": "Id"
          },
          "name": {
            "type": "string",
            "title": "Name"
          },
          "category": {
            "type": "string",
            "title": "Category"
          },
          "category_label": {
            "type": "string",
            "title": "Category Label"
          },
          "version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Version"
          },
          "confidence": {
            "type": "integer",
            "title": "Confidence"
          },
          "evidence": {
            "items": {
              "$ref": "#/components/schemas/Evidence"
            },
            "type": "array",
            "title": "Evidence"
          },
          "website": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Website"
          }
        },
        "type": "object",
        "required": [
          "id",
          "name",
          "category",
          "category_label",
          "version",
          "confidence",
          "evidence",
          "website"
        ],
        "title": "Technology"
      },
      "TlsCell": {
        "properties": {
          "ok": {
            "type": "boolean",
            "title": "Ok"
          },
          "version": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Version"
          },
          "name_matches": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Name Matches"
          },
          "alert": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Alert"
          }
        },
        "type": "object",
        "required": [
          "ok",
          "version",
          "name_matches",
          "alert"
        ],
        "title": "TlsCell"
      },
      "TlsInfo": {
        "properties": {
          "version": {
            "type": "string",
            "title": "Version"
          },
          "cipher": {
            "type": "string",
            "title": "Cipher"
          },
          "forward_secrecy": {
            "type": "boolean",
            "title": "Forward Secrecy"
          },
          "alpn": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Alpn"
          },
          "versions": {
            "additionalProperties": {
              "anyOf": [
                {
                  "type": "boolean"
                },
                {
                  "type": "null"
                }
              ]
            },
            "type": "object",
            "title": "Versions",
            "description": "TLS versions accepted (true), refused (false) or not tested (null)."
          },
          "non_forward_secret": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Non Forward Secret",
            "description": "Whether plain RSA key exchange (no forward secrecy) is accepted; null = not tested."
          },
          "ocsp_stapled": {
            "type": "boolean",
            "title": "Ocsp Stapled"
          },
          "ocsp": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/OcspInfo"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "version",
          "cipher",
          "forward_secrecy",
          "alpn",
          "versions",
          "non_forward_secret",
          "ocsp_stapled",
          "ocsp"
        ],
        "title": "TlsInfo"
      },
      "TlsRptData": {
        "properties": {
          "verdict": {
            "type": "string",
            "enum": [
              "valid",
              "missing",
              "broken",
              "unknown"
            ],
            "title": "Verdict"
          },
          "present": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Present"
          },
          "records": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Records"
          },
          "rua": {
            "items": {
              "additionalProperties": true,
              "type": "object"
            },
            "type": "array",
            "title": "Rua"
          }
        },
        "type": "object",
        "required": [
          "verdict",
          "present",
          "records",
          "rua"
        ],
        "title": "TlsRptData"
      },
      "ToolResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "additionalProperties": true,
            "type": "object",
            "title": "Data"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "credits_remaining"
        ],
        "title": "ToolResponse",
        "description": "The result envelope plus the caller's balance after this call."
      },
      "ToolResult": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "additionalProperties": true,
            "type": "object",
            "title": "Data"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary"
        ],
        "title": "ToolResult",
        "description": "One result envelope inside a batch or job (no balance of its own)."
      },
      "ToolScores": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "per_domain": {
            "items": {
              "anyOf": [
                {
                  "type": "integer"
                },
                {
                  "type": "null"
                }
              ]
            },
            "type": "array",
            "title": "Per Domain"
          },
          "best": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Best"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "per_domain",
          "best"
        ],
        "title": "ToolScores"
      },
      "TrustInfo": {
        "properties": {
          "trusted": {
            "type": "boolean",
            "title": "Trusted"
          },
          "hostname_match": {
            "type": "boolean",
            "title": "Hostname Match"
          },
          "root": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Root"
          },
          "path": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Path"
          },
          "reason": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/dnssuper_core__tls_trust__Reason"
              },
              {
                "type": "null"
              }
            ]
          }
        },
        "type": "object",
        "required": [
          "trusted",
          "hostname_match",
          "root",
          "path",
          "reason"
        ],
        "title": "TrustInfo"
      },
      "TrustStoreInfo": {
        "properties": {
          "source": {
            "type": "string",
            "title": "Source"
          },
          "version": {
            "type": "string",
            "title": "Version"
          }
        },
        "type": "object",
        "required": [
          "source",
          "version"
        ],
        "title": "TrustStoreInfo"
      },
      "UpdateChannel": {
        "properties": {
          "name": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 60,
                "minLength": 1
              },
              {
                "type": "null"
              }
            ],
            "title": "Name"
          },
          "url": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 2048
              },
              {
                "type": "null"
              }
            ],
            "title": "Url"
          },
          "recipients": {
            "anyOf": [
              {
                "items": {
                  "type": "string",
                  "format": "uuid"
                },
                "type": "array",
                "maxItems": 50
              },
              {
                "type": "null"
              }
            ],
            "title": "Recipients"
          },
          "digest": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Digest"
          },
          "digest_hour": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 23,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Digest Hour"
          },
          "paused": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Paused"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "UpdateChannel"
      },
      "UpdateMonitor": {
        "properties": {
          "label": {
            "anyOf": [
              {
                "type": "string",
                "maxLength": 80
              },
              {
                "type": "null"
              }
            ],
            "title": "Label"
          },
          "interval": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Interval"
          },
          "options": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Options"
          },
          "rules": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Rules"
              },
              {
                "type": "null"
              }
            ]
          },
          "channel_ids": {
            "anyOf": [
              {
                "items": {
                  "type": "string",
                  "format": "uuid"
                },
                "type": "array",
                "maxItems": 10
              },
              {
                "type": "null"
              }
            ],
            "title": "Channel Ids"
          },
          "paused": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Paused"
          }
        },
        "additionalProperties": false,
        "type": "object",
        "title": "UpdateMonitor"
      },
      "UptimeDay": {
        "properties": {
          "day": {
            "type": "string",
            "format": "date",
            "title": "Day"
          },
          "checks": {
            "type": "integer",
            "title": "Checks"
          },
          "up": {
            "type": "integer",
            "title": "Up"
          },
          "avg_ms": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Avg Ms"
          },
          "max_ms": {
            "type": "integer",
            "title": "Max Ms"
          }
        },
        "type": "object",
        "required": [
          "day",
          "checks",
          "up",
          "avg_ms",
          "max_ms"
        ],
        "title": "UptimeDay"
      },
      "UptimeView": {
        "properties": {
          "uptime_pct": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Uptime Pct"
          },
          "days": {
            "items": {
              "$ref": "#/components/schemas/UptimeDay"
            },
            "type": "array",
            "title": "Days"
          }
        },
        "type": "object",
        "required": [
          "uptime_pct",
          "days"
        ],
        "title": "UptimeView"
      },
      "Usage": {
        "properties": {
          "used": {
            "type": "integer",
            "title": "Used"
          },
          "limit": {
            "type": "integer",
            "title": "Limit"
          }
        },
        "type": "object",
        "required": [
          "used",
          "limit"
        ],
        "title": "Usage"
      },
      "UsageItem": {
        "properties": {
          "time": {
            "type": "string",
            "format": "date-time",
            "title": "Time"
          },
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "credits": {
            "type": "integer",
            "title": "Credits"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached"
          },
          "status": {
            "type": "string",
            "enum": [
              "ok",
              "partial",
              "error"
            ],
            "title": "Status"
          }
        },
        "type": "object",
        "required": [
          "time",
          "tool",
          "target",
          "credits",
          "cached",
          "status"
        ],
        "title": "UsageItem"
      },
      "Verdict": {
        "type": "string",
        "enum": [
          "available",
          "taken",
          "unknown",
          "restricted"
        ]
      },
      "VerificationCheck": {
        "properties": {
          "domain": {
            "type": "string",
            "title": "Domain"
          },
          "verified": {
            "type": "boolean",
            "title": "Verified",
            "description": "True when the record is published with the right value"
          }
        },
        "type": "object",
        "required": [
          "domain",
          "verified"
        ],
        "title": "VerificationCheck"
      },
      "VerificationRecord": {
        "properties": {
          "domain": {
            "type": "string",
            "title": "Domain",
            "description": "The registrable domain the record proves"
          },
          "record_name": {
            "type": "string",
            "title": "Record Name",
            "description": "Where to publish the TXT record"
          },
          "record_value": {
            "type": "string",
            "title": "Record Value",
            "description": "The TXT record's exact value"
          }
        },
        "type": "object",
        "required": [
          "domain",
          "record_name",
          "record_value"
        ],
        "title": "VerificationRecord"
      },
      "VerificationRecordView": {
        "properties": {
          "domain": {
            "type": "string",
            "title": "Domain"
          },
          "record_name": {
            "type": "string",
            "title": "Record Name"
          },
          "record_value": {
            "type": "string",
            "title": "Record Value"
          }
        },
        "type": "object",
        "required": [
          "domain",
          "record_name",
          "record_value"
        ],
        "title": "VerificationRecordView"
      },
      "VerificationRequest": {
        "properties": {
          "domain": {
            "type": "string",
            "maxLength": 253,
            "minLength": 1,
            "title": "Domain",
            "examples": [
              "example.com"
            ]
          }
        },
        "additionalProperties": false,
        "type": "object",
        "required": [
          "domain"
        ],
        "title": "VerificationRequest"
      },
      "VerifyResult": {
        "properties": {
          "verified": {
            "type": "boolean",
            "title": "Verified"
          },
          "status_class": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status Class"
          }
        },
        "type": "object",
        "required": [
          "verified",
          "status_class"
        ],
        "title": "VerifyResult"
      },
      "WebProbe": {
        "properties": {
          "family6": {
            "$ref": "#/components/schemas/ProbeSide"
          },
          "family4": {
            "$ref": "#/components/schemas/ProbeSide"
          },
          "same": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Same"
          }
        },
        "type": "object",
        "required": [
          "family6",
          "family4",
          "same"
        ],
        "title": "WebProbe"
      },
      "Website": {
        "properties": {
          "scheme": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "https",
                  "http"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Scheme"
          },
          "status": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Status"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "error": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Error"
          }
        },
        "type": "object",
        "title": "Website"
      },
      "WebsiteLogoData": {
        "properties": {
          "url": {
            "type": "string",
            "title": "Url"
          },
          "final_url": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Final Url"
          },
          "title": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Title"
          },
          "description": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Description"
          },
          "canonical": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Canonical"
          },
          "lang": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Lang"
          },
          "site_name": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Site Name"
          },
          "social_profiles": {
            "items": {
              "additionalProperties": {
                "type": "string"
              },
              "type": "object"
            },
            "type": "array",
            "title": "Social Profiles"
          },
          "icons": {
            "items": {
              "$ref": "#/components/schemas/IconOut"
            },
            "type": "array",
            "title": "Icons"
          },
          "logo": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/LogoOut"
              },
              {
                "type": "null"
              }
            ]
          },
          "manifest": {
            "anyOf": [
              {
                "additionalProperties": true,
                "type": "object"
              },
              {
                "type": "null"
              }
            ],
            "title": "Manifest"
          }
        },
        "type": "object",
        "required": [
          "url",
          "final_url",
          "title",
          "description",
          "canonical",
          "lang",
          "site_name",
          "social_profiles",
          "icons",
          "logo",
          "manifest"
        ],
        "title": "WebsiteLogoData",
        "description": "A site's title, description, language, social profiles, icons and logo."
      },
      "WebsiteLogoResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/WebsiteLogoData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "WebsiteLogoResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "WhoisLookupData": {
        "properties": {
          "name": {
            "type": "string",
            "title": "Name"
          },
          "unicode": {
            "type": "string",
            "title": "Unicode"
          },
          "tld": {
            "type": "string",
            "title": "Tld"
          },
          "tier": {
            "type": "string",
            "enum": [
              "A",
              "B",
              "C",
              "D"
            ],
            "title": "Tier"
          },
          "source": {
            "anyOf": [
              {
                "type": "string",
                "enum": [
                  "rdap",
                  "whois"
                ]
              },
              {
                "type": "null"
              }
            ],
            "title": "Source"
          },
          "registered": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Registered"
          },
          "reduced_from": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Reduced From"
          },
          "registrar": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/Registrar"
              },
              {
                "type": "null"
              }
            ]
          },
          "created": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Created"
          },
          "updated": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Updated"
          },
          "expires": {
            "anyOf": [
              {
                "type": "string"
              },
              {
                "type": "null"
              }
            ],
            "title": "Expires"
          },
          "age_days": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Age Days"
          },
          "days_to_expiry": {
            "anyOf": [
              {
                "type": "integer"
              },
              {
                "type": "null"
              }
            ],
            "title": "Days To Expiry"
          },
          "statuses": {
            "items": {
              "$ref": "#/components/schemas/dnssuper_core__registration__record__Status"
            },
            "type": "array",
            "title": "Statuses"
          },
          "nameservers": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Nameservers"
          },
          "dnssec": {
            "anyOf": [
              {
                "type": "boolean"
              },
              {
                "type": "null"
              }
            ],
            "title": "Dnssec"
          },
          "redacted_fields": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Redacted Fields"
          },
          "unpublished_fields": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Unpublished Fields"
          },
          "unparsed_fields": {
            "items": {
              "type": "string"
            },
            "type": "array",
            "title": "Unparsed Fields"
          },
          "attempts": {
            "items": {
              "$ref": "#/components/schemas/AttemptData"
            },
            "type": "array",
            "title": "Attempts"
          },
          "raw": {
            "anyOf": [
              {
                "$ref": "#/components/schemas/RawRecord"
              },
              {
                "type": "null"
              }
            ]
          },
          "retry_after_s": {
            "anyOf": [
              {
                "type": "number"
              },
              {
                "type": "null"
              }
            ],
            "title": "Retry After S"
          }
        },
        "type": "object",
        "required": [
          "name",
          "unicode",
          "tld",
          "tier"
        ],
        "title": "WhoisLookupData",
        "description": "`data` of a whois-lookup envelope. Dates are ISO 8601 in UTC; `raw` is scrubbed of contacts."
      },
      "WhoisLookupResponse": {
        "properties": {
          "tool": {
            "type": "string",
            "title": "Tool"
          },
          "target": {
            "type": "string",
            "title": "Target"
          },
          "status": {
            "$ref": "#/components/schemas/dnssuper_core__envelope__Status"
          },
          "fetched_at": {
            "type": "string",
            "format": "date-time",
            "title": "Fetched At"
          },
          "cached": {
            "type": "boolean",
            "title": "Cached",
            "default": false
          },
          "credits_used": {
            "type": "integer",
            "title": "Credits Used",
            "description": "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",
            "default": 0
          },
          "summary": {
            "type": "string",
            "title": "Summary"
          },
          "score": {
            "anyOf": [
              {
                "type": "integer",
                "maximum": 100,
                "minimum": 0
              },
              {
                "type": "null"
              }
            ],
            "title": "Score"
          },
          "findings": {
            "items": {
              "$ref": "#/components/schemas/Finding"
            },
            "type": "array",
            "title": "Findings"
          },
          "data": {
            "$ref": "#/components/schemas/WhoisLookupData"
          },
          "credits_remaining": {
            "type": "integer",
            "title": "Credits Remaining",
            "description": "Your balance after this call. It can be below zero after a refund; free tools still work then"
          }
        },
        "type": "object",
        "required": [
          "tool",
          "target",
          "status",
          "summary",
          "data",
          "credits_remaining"
        ],
        "title": "WhoisLookupResponse",
        "description": "The result envelope with this tool's data, plus the caller's balance."
      },
      "dnssuper_core__envelope__Status": {
        "type": "string",
        "enum": [
          "ok",
          "partial",
          "error"
        ],
        "title": "Status"
      },
      "dnssuper_core__registration__record__Status": {
        "properties": {
          "code": {
            "type": "string",
            "title": "Code"
          },
          "meaning": {
            "type": "string",
            "title": "Meaning"
          },
          "set_by": {
            "type": "string",
            "enum": [
              "registrar",
              "registry",
              "unknown"
            ],
            "title": "Set By"
          }
        },
        "type": "object",
        "required": [
          "code",
          "meaning",
          "set_by"
        ],
        "title": "Status"
      },
      "dnssuper_core__tls_trust__Reason": {
        "type": "string",
        "enum": [
          "expired",
          "not_yet_valid",
          "hostname",
          "self_signed",
          "missing_intermediate",
          "untrusted_root",
          "invalid"
        ]
      },
      "dnssuper_core__tools__domain_availability__Reason": {
        "type": "string",
        "enum": [
          "delegated",
          "registry_not_found",
          "registered_without_dns",
          "reserved",
          "brand_tld",
          "dns_only",
          "dns_inconclusive"
        ]
      }
    },
    "securitySchemes": {
      "ApiKey": {
        "type": "http",
        "description": "Your API key: `Authorization: Bearer live_...` (`test_...` outside production).",
        "scheme": "bearer"
      }
    },
    "headers": {
      "X-Request-Id": {
        "description": "UUID4 identifying this request; echoes the client's value if it sent a valid one",
        "schema": {
          "type": "string",
          "format": "uuid"
        }
      }
    }
  }
}