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 (punycode) form:

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

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}

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