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, and dnssec naming the RFC 5910 interface, digest types and algorithms the registry takes on a DNSSEC change.

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"
  },
  "dnssec": {
    "object": "tld_dnssec",
    "model": "ds_data",
    "digest_types": [
      2,
      4
    ],
    "algorithms": [
      8,
      13,
      14,
      15,
      16
    ],
    "ds_dnskey": true,
    "max_records": 13
  }
}

TLD resource