Get TLD

​

Returns a single TLD by name. Returns the TLD regardless of enabled status. The payload includes period_unit, min_period, and max_period so clients can bound their registration-term selector against the values the registry accepts.

Error Codes
Code HTTP Description
tld.not_found 404 TLD does not exist
Path Parameters
  • name
    Type: string
    required

    TLD name (e.g., com, net, io)

Responses
  • application/json
  • application/json
Request Example for get/tlds/{name}
curl 'https://api.nametrust.com/tlds/{name}'

{
  "object": "tld",
  "name": "com",
  "category": "gtld",
  "period_unit": "y",
  "min_period": 1,
  "max_period": 10,
  "icann_fee": {
    "object": "money",
    "amount": 18,
    "currency": "USD"
  }
}

TLD resource