tlds

List TLD extended attributes

Changed on Jul 11, 2025

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

Request

Base URL
https://api.dnsimple.com/v2
Auth
- HTTP basic
- or HTTP bearer
TypeScript
https://skmtc.dev/dnsimple/apis/dnsimple-api/docs/tlds/:tld/extended_attributes/get.ts
A function with typed inputs. Its response is checked against the schema.

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

Jul 11, 2025v206780be0ef17 Revision changes
- info
  the response property became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property // became required for the status
- info
  the response property //// became required for the status
- info
  the response property //// became required for the status
- info
  the response property //// became required for the status
- info
  the response property // became required for the status
- info
  the response property became required for the status
- info
  added the required property // to the response with the status
Jul 18, 2023v2c8591dcf8c29 Revision changes
- breaking
  the response property became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property //// became optional for the status
- breaking
  the response property //// became optional for the status
- breaking
  the response property //// became optional for the status
- breaking
  the response property // became optional for the status
- breaking
  the response property became optional for the status
- breaking
  removed the required property // from the response with the status

Operation history