tld-api

Validates whether a TLD (Top-Level Domain) exists, against a locally cached copy of the IANA TLD list.

Endpoint

GET /{tld}

{tld} is the TLD to check, without a leading dot. It can be given in ASCII (e.g. com, xn--p1ai) or in its original script (e.g. рф, 澳門, 한국) — it is automatically converted to its canonical punycode form before being checked.

Response

JSON body, in both success and failure cases. tld is always the canonical ASCII form. An input field is added when it differs from what was actually requested (e.g. a native-script TLD, or different casing):

{"tld": "com", "valid": true}
{"tld": "xn--mix891f", "valid": true, "input": "澳門"}

HTTP status	Meaning
200	The TLD exists in the cached IANA list
404	The TLD does not exist, or is not a validly formatted TLD

Examples

GET /com
200 {"tld":"com","valid":true}

GET /澳門
200 {"tld":"xn--mix891f","valid":true,"input":"澳門"}

GET /notarealtld
404 {"tld":"notarealtld","valid":false}