Skip to main content
GET
/
core
/
v1
/
domains
/
{domainName}
:getPricing
Get Pricing For Domain
curl --request GET \
  --url https://api.dev.name.com/core/v1/domains/{domainName}:getPricing \
  --header 'Authorization: Basic <encoded-value>'
{
  "premium": true,
  "purchasePrice": 24.99,
  "renewalPrice": 24.99,
  "transferPrice": 24.99
}

Authorizations

​
Authorization
string
header
required

Authenticate via HTTP Basic with your account username and API token. Examples use an explicit 'Authorization: Basic <base64(username:token)>' header; 'curl -u username:token' is equivalent. For sandbox, append "-test" to your username and use your sandbox token on api.dev.name.com.

Path Parameters

​
domainName
string
required

DomainName is the domain to retrieve.

Query Parameters

​
years
integer

Years specifies the time period in years to get pricing for the domain. Years defaults to the minimum time period (typically 1 year) if not passed and cannot be more than 10. Some TLDs default to longer periods (e.g. .AI requires 2 year periods).

Example:

2

Response

A successful response.

PricingResponse returns the Pricing related information from the GetPricingForDomain function.

​
premium
boolean
required

Premium indicates that this pricing is a premium result and the respective prices must be passed in create, renew or transfer commands.

​
purchasePrice
number | null
required

PurchasePrice is the price you will pay to register a domain. Can be passed in the CreateDomain request. If purchasePrice returns as null, it means that name.com is not currently accepting registrations for this combination of TLD and duration. If this is unexpected, please contact support.

Example:

24.99

​
renewalPrice
number | null
required

RenewalPrice is the price you will pay to renew a domain. Can be passed in the RenewDomain request. If renewalPrice returns as null, it means that name.com is not currently accepting renewals for this combination of TLD and duration. If this is unexpected, please contact support.

Example:

24.99

​
transferPrice
number | null
required

TransferPrice is the price you will pay to transfer a domain. Can be passed in the CreateTransfer request. The TransferPrice is always for 1 year regardless of the years input. If transferPrice returns as null, it means that name.com is not currently accepting transfers for this combination of TLD and duration. If this is unexpected, please contact support.

Example:

24.99

⌘I