Get TLD price data | Vercel REST API

APIs & SDKs

Get TLD price data

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

Get price data for a specific TLD. This only reflects base prices for the given TLD. Premium domains may have different prices. Use the Get price data for a domain endpoint to get the price data for a specific domain.

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

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

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

Response

{
  "years": "123",
  "purchasePrice": "123",
  "renewalPrice": "123",
  "transferPrice": "123"
}

Errors

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

Path parameters

tldanyRequired

Query parameters

yearsstringOptional

The number of years to get the price for. If not provided, the minimum number of years for the TLD will be used.

teamIdstringOptional

Response

200Success

yearsnumberRequired

The number of years the returned price is for.

purchasePriceobjectRequired2 variants

renewalPriceobjectRequired2 variants

transferPriceobjectRequired2 variants

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 price data (/docs/rest-api/domains-registrar/get-tld-price-data)

From the Vercel docs graph (built 2026-10-07T05:48:34.144Z), 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 price data for a domain — GET /v1/registrar/domains/{domain}/price — Get price data for a specific domain
Get TLD — GET /v1/registrar/tlds/{tld} — Get the metadata for a specific TLD.
Get price data for multiple domains — POST /v1/registrar/domains/price — Get price data for multiple domains in a single request.
Get Domain Availability and Pricing — POST /v1/registrar/domains/search — Start domain research here. Get registration availability and pricing for 1–200 exac
Buy a domain — POST /v1/registrar/domains/{domain}/buy — Buy a domain

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 (2)

By site: vercel-docs (2)

Programmatic Domain Management — Programmatically search, price, purchase, renew, and manage domains with Vercel's domains registrar API endpoints.
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}/price

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

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

Response

{
  "years": "123",
  "purchasePrice": "123",
  "renewalPrice": "123",
  "transferPrice": "123"
}

Errors

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

OpenAPI Specification