Sign in

v1

latestOpenAPI 3.1.02026-07-2671111437.2 KB
Domains

Get Pricing For Domain

Returns registration, renewal, and transfer pricing for a domain and term.

Not a discovery endpoint: Does not return purchaseType. Cannot determine whether a domain is acquired via registration vs aftermarket/expiring/backorder — call Search or Check Availability first.

Scope: purchasePrice and premium reflect standard and registry-premium registration only. They do not return aftermarket, expiring, or backorder acquisition prices. For those types, use purchasePrice from Search or Check Availability.

Registration create (purchaseType: registration): When create requires purchasePrice (registry premium), call with the same years you will send on create. Pass purchasePrice directly — it is the total for that term, not a per-year component.

Renew: Pass renewalPrice as purchasePrice on Renew Domain for premium renewals — not for computing Create Domain totals.

Transfer: Pass transferPrice as purchasePrice on Create Transfer for premium transfers. The years query parameter does not affect transferPrice.

See the Domain pricing guide for the full workflow.

get/core/v1/domains/{domainName}:getPricing

Path parameters

domainNamestring required

DomainName is the domain to retrieve.

Query parameters

yearsinteger
Example:2

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.

Response

A successful response.

premiumboolean 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.

purchasePricenumber double nullable 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.

renewalPricenumber double nullable 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.

transferPricenumber double nullable 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 response

{
  "purchasePrice": 24.99,
  "renewalPrice": 24.99,
  "transferPrice": 24.99
}