Reference

TLD registry & type reference API

Given a TLD ('.com', 'uk') or a hostname ('example.co.jp'), return the sponsoring registry, the type (gTLD/ccTLD/sponsored/new-gTLD), the associated country for ccTLDs, and IDN/DNSSEC support flags — the value-add over a flat IANA list. Answers 'who runs .com', 'is .io a country code', 'registry for .org', 'country for .de'.

Price$0.01per request

MethodPOST

Route/v1/ref/tld

StatusLive

MIME typeapplication/json

Rate limit60/minute

CacheNo cache

reftlddomainianaregistrygtldcctlddns

API URLhttps://x402.hexl.dev/v1/ref/tld

Integration docs

Example request

{
  "query": ".de"
}

Example response

{
  "query": ".de",
  "tld": "de",
  "found": true,
  "registry": "DENIC eG",
  "type": "ccTLD",
  "country": "Germany",
  "idn": true,
  "dnssec": true
}

Input schema

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "examples": [
        ".com",
        "uk",
        "example.co.jp"
      ]
    }
  }
}

Output schema

{
  "type": "object",
  "additionalProperties": true
}