Skip to main content

tld_prices

Creates, updates, deletes, gets or lists a tld_prices resource.

Overview

Nametld_prices
TypeResource
Idvercel.domains_registrar.tld_prices

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
purchase_pricenumber (wire: purchasePrice)
renewal_pricenumber (wire: renewalPrice)
transfer_pricenumber (wire: transferPrice)
yearsnumberThe number of years the returned price is for.

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
getselecttldyears, team_idGet 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](https:​//vercel.com/docs/rest-api/reference/endpoints/domains-registrar/get-price-data-for-a-domain) endpoint to get the price data for a specific domain.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

NameDatatypeDescription
tldstring
team_idstring (wire: teamId)
yearsstringThe number of years to get the price for. If not provided, the minimum number of years for the TLD will be used.

SELECT examples

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.

SELECT
purchase_price,
renewal_price,
transfer_price,
years
FROM vercel.domains_registrar.tld_prices
WHERE tld = '{{ tld }}' -- required
AND years = '{{ years }}'
AND team_id = '{{ team_id }}'
;