tlds

List TLD extended attributes

Lists a TLD extended attributes.

Some TLDs require extended attributes when registering or transferring a domain. This API interface provides information on the extended attributes for any particular TLD. Extended attributes are extra TLD-specific attributes, required by the TLD registry to collect extra information about the registrant or legal agreements.

get/tlds/{tld}/extended_attributes

Path parameters

tldstring required

The TLD string

Response

Successfully retrieved the extended attributes for the TLD.

Example response

{
  "data": [
    {
      "name": "uk_legal_type",
      "description": "Legal type of registrant contact",
      "required": true,
      "options": [
        {
          "title": "UK Individual",
          "value": "IND",
          "description": "UK Individual (our default value)"
        },
        {
          "title": "Non-UK Individual (representing self)",
          "value": "FIND",
          "description": "Non-UK Individual (representing self)"
        }
      ],
      "title": "UK Legal Type"
    }
  ]
}

Changes

Changed in 2 of the 52 revisions of this API.1010

Jul 11, 2025v206780be0ef1710See the full diff
- ○
  the response property data became required for the status 200
  response-property-became-required
- ○
  the response property data/items/description became required for the status 200
  response-property-became-required
- ○
  the response property data/items/name became required for the status 200
  response-property-became-required
- ○
  the response property data/items/options became required for the status 200
  response-property-became-required
- ○
  the response property data/items/options/items/description became required for the status 200
  response-property-became-required
- ○
  the response property data/items/options/items/title became required for the status 200
  response-property-became-required
- ○
  the response property data/items/options/items/value became required for the status 200
  response-property-became-required
- ○
  the response property data/items/required became required for the status 200
  response-property-became-required
- ○
  the response property message became required for the status 404
  response-property-became-required
- ○
  added the required property data/items/title to the response with the 200 status
  response-required-property-added
Jul 18, 2023v2c8591dcf8c2910See the full diff
- ▲
  the response property data became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/items/description became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/items/name became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/items/options became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/items/options/items/description became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/items/options/items/title became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/items/options/items/value became optional for the status 200
  response-property-became-optional
- ▲
  the response property data/items/required became optional for the status 200
  response-property-became-optional
- ▲
  the response property message became optional for the status 404
  response-property-became-optional
- ▲
  removed the required property data/items/title from the response with the 200 status
  response-required-property-removed
This revision also has 25 changes that name no endpoint, such as unreferenced schemas being removed. See the revision's changelog

Full history