TLD details

Retrieve registry metadata and contacts for a top-level domain.

← All Domains endpoints · Capability overview

GET/v1/domains/tlds/{tld}

https://api.vee3.io/v1/domains/tlds/{tld}

1 tokens

Retrieve registry metadata and contacts for a top-level domain.

Authorization

Send your API key in the Authorization header:

Authorization: Bearer YOUR_API_KEY

MCP

The same capability is available as an MCP tool on Vee3 hosted MCP.

Tool name

get_domain_tld_details

Parameters1 field

tldstringRequired

TLD suffix to look up without a leading dot (for example io).

max length 63

Response22 fields

tldstring

TLD suffix without a leading dot.

statusstring

Delegation status (for example ACTIVE).

typestring

TLD category (for example country-code or generic).

levelinteger

TLD level (1 for standard TLDs).

availabilitystring

Registration phase for the TLD.

whois_serverstring

Authoritative WHOIS server host name.

rdap_serverstring

Authoritative RDAP server URL.

registry_urlstring

Registry web site URL.

domains_countinteger

Approximate registered domain count when reported by the registry.

createdstring

TLD delegation created timestamp.

changedstring

TLD record last changed timestamp.

contactsarrayitems

6 fields

Registry contact records.

namestring

Contact name.

phonestring

Contact phone number.

e-mailstring

Contact email address.

addressstring

Contact postal address.

contactstring

Contact role (for example administrative or technical).

organisationstring

Contact organization name.

organizationobject

2 fields

Registry operator contact details.

organisationstring

Registry operator name.

addressstring

Registry operator postal address.

remarksstring

Additional registry notes or links.

HTTP errors: unauthorized, validation_error, insufficient_tokens, payment_required, domains_not_configured, domains_upstream_error

Example request

Python

import requests

url = "https://api.vee3.io/v1/domains/tlds/{tld}"
headers = {
    "Authorization": "Bearer YOUR_API_KEY",
}
params = {
    "tld": "ai"
}

response = requests.get(url, headers=headers, params=params)
response.raise_for_status()
data = response.json()
print(data)

Example responses1 example

200Sample registry metadata for .ai.

ai_registry_details.json

{
  "tld": "ai",
  "status": "ACTIVE",
  "type": "country-code",
  "level": 1,
  "availability": "general-availability",
  "whois_server": "whois.nic.ai",
  "rdap_server": "https://rdap.identitydigital.services/rdap/",
  "registry_url": "https://nic.ai",
  "domains_count": 1000000,
  "created": "1995-02-16T00:00:00.000Z",
  "changed": "2025-02-11T00:00:00.000Z",
  "contacts": [
    {
      "name": "Telecommunications Officer",
      "phone": "+1 264 497 5233",
      "e-mail": "telecommunications.office@gov.ai",
      "address": "Coronation Avenue, PO Box 60\nThe Valley AI2640\nAnguilla",
      "contact": "administrative",
      "organisation": "Government of Anguilla, Ministry of Infrastructure, Communications and Utilities"
    }
  ],
  "organization": {
    "address": "Coronation Avenue, PO Box 60\nThe Valley AI2640\nAnguilla",
    "organisation": "Government of Anguilla"
  },
  "remarks": "Registration information: https://nic.ai"
}