Vee3

List TLDs

Search and paginate top-level domains with registry metadata.

← All Domains endpoints · Capability overview

GET/v1/domains/tlds

https://api.vee3.io/v1/domains/tlds

2 tokens

Search and paginate top-level domains with registry metadata.

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

list_domain_tlds
Parameters5 fields
searchstringOptional

Return TLDs whose suffix contains this substring.

max length 63

availabilitystringOptional

Filter by registration phase: general-availability (normal public registration) or sunrise (early trademark-holder period).

tld_typestringOptional

Filter by TLD category: country-code, generic, generic-restricted, infrastructure, or sponsored.

limitintegerOptional

Maximum number of TLDs to return. Defaults to 100 when omitted.

min 1

pageintegerOptional

Page number for paginated results.

min 1

Response12 fields
tldsarrayitems
11 fields

Matching top-level domain records.

tldstring

TLD suffix without a leading dot (for example com).

typestring

TLD category (for example country-code or generic). Null when the upstream registry has not classified the TLD.

levelinteger

TLD level (1 for standard TLDs).

availabilitystring

Registration phase for the TLD. Null on unfiltered list results when the upstream registry has not published phase metadata.

whois_serverstring

Authoritative WHOIS server host name.

domains_countinteger

Approximate registered domain count when reported by the registry.

organizationobject
2 fields

Registry operator contact details.

organisationstring

Registry operator name.

addressstring

Registry operator postal address.

createdstring

TLD delegation created timestamp.

changedstring

TLD record last changed timestamp.

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