Get TLD | Vercel REST API

APIs & SDKs

Get TLD

GEThttps://api.vercel.com/v1/registrar/tlds/{tld}

Get the metadata for a specific TLD.

https://api.vercel.com/v1/registrar/tlds/{tld}

const response = await fetch('https://api.vercel.com/v1/registrar/tlds/tld?teamId=string', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Response

{
  "supportedLanguageCodes": {}
}

Errors

{
  "status": "400",
  "code": "tld_not_supported",
  "message": "string"
}

Path parameters

tldanyRequired

Query parameters

teamIdstringOptional

Response

200Success

supportedLanguageCodesobjectRequired

The language codes that are supported for the TLD. The key is the language code, and the value is the name of the language.

Errors

400There was something wrong with the request

statusnumberRequired

codestringRequired

messagestringRequired

401Unauthorized

statusnumberRequired

codestringRequired

messagestringRequired

reasonstringOptional

403NotAuthorizedForScope

statusnumberRequired

codestringRequired

messagestringRequired

429TooManyRequests

statusnumberRequired

codestringRequired

messagestringRequired

retryAfterobjectRequired

limitobjectRequired

500InternalServerError

statusnumberRequired

codestringRequired

messagestringRequired

Cross-link map: Get TLD (/docs/rest-api/domains-registrar/get-tld)

From the Vercel docs graph (built 2026-10-08T05:38:39.548Z), spanning vercel.com docs + KB, nextjs.org, ai-sdk.dev, and other Vercel documentation sites. Full graph as JSON: https://vercel.com/docs/graph.json

Semantically closest pages

Get TLD price data — GET /v1/registrar/tlds/{tld}/price — Get price data for a specific TLD. This only reflects base prices for the given TLD
Get price data for a domain — GET /v1/registrar/domains/{domain}/price — Get price data for a specific domain
Get a domain's transfer status — GET /v1/registrar/domains/{domain}/transfer — Get the transfer status for a domain
Get Domain Availability and Pricing — POST /v1/registrar/domains/search — Start domain research here. Get registration availability and pricing for 1–200 exac
Get a domain order — GET /v1/registrar/orders/{orderId} — Get information about a domain order by its ID

This page links to (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

Pages that link here (1)

By site: vercel-docs (1)

Vercel REST API Reference — Interact programmatically with your Vercel account using the SDK or direct HTTP requests.

https://api.vercel.com/v1/registrar/tlds/{tld}

const response = await fetch('https://api.vercel.com/v1/registrar/tlds/tld?teamId=string', {
  method: 'GET',
  headers: {
    'Authorization': 'Bearer YOUR_ACCESS_TOKEN',
    'Content-Type': 'application/json',
  },
});

const data = await response.json();
console.log(data);

Response

{
  "supportedLanguageCodes": {}
}

Errors

{
  "status": "400",
  "code": "tld_not_supported",
  "message": "string"
}

OpenAPI Specification