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<int32>

Years specifies the registration term to price in years. Defaults to each TLD's minimum registration term if omitted — usually 1 year (2 for .ai). Must be a supported registration term for the TLD (commonly 1–10 years). Use the same value on Create Domain when passing purchasePrice for purchaseType: registration.

Example:

2

Response

A successful response.

PricingResponse returns the Pricing related information from the GetPricingForDomain endpoint. Covers standard and registry-premium registration pricing, plus renewal and transfer. Not a discovery endpoint — does not return purchaseType. Does not return aftermarket, expiring, or backorder acquisition prices. See the Domain pricing guide.

premium
boolean
required

Premium indicates whether this registration pricing result is for a registry premium or other non-standard registration. Reflects registration pricing only — may differ from discovery premium for aftermarket, expiring, or backorder results. When true, purchasePrice must be passed on Create Domain, Renew Domain, or Create Transfer, requests.

purchasePrice
number<double> | null
required

PurchasePrice is the total standard or registry-premium registration cost for the requested years query parameter — not a one-year component. Does not include aftermarket, expiring, or backorder acquisition prices. If null, name.com is not currently accepting registrations for this domain/term combination. For registry premium create (purchaseType: registration), pass this value with the same years. For aftermarket, expiring, or backorder types, use purchasePrice from Search/Check Availability instead.

Example:

24.99

renewalPrice
number<double> | null
required

RenewalPrice is the total renewal cost for the requested years. If null, name.com is not currently accepting renewals for this domain/term combination. Pass as purchasePrice on Renew Domain for premium renewals. Do not use for computing Create Domain purchasePrice or multi-year create totals.

Example:

24.99

transferPrice
number<double> | null
required

TransferPrice is the inbound transfer cost for this domain. The years query parameter does not affect this value. Pricing uses the TLD's minimum transfer/registration term (typically 1 year; for TLDs with a higher minimum, e.g. .ai, the total will reflect that minimum). If null, transfers are not accepted for this domain/term combination. Pass to Create Transfer as purchasePrice when transfer price validation applies (required for premium transfers).

Example:

24.99