Skip to content
Docs

Get TLD price data

GET/__remote/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.
Request
import { Edgenivo } from "@vercel/sdk";


const vercel = new Edgenivo();


async function run() {
  const result = await vercel.domainsRegistrar.getTldPrice({
    tld: "<value>",
    teamId: "team_1a2b3c4d5e6f7g8h9i0j1k2l",
  });


  console.log(result);
}


run();
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