TLD Price List

This endpoint returns an alphabetical list of all TLDs supported by name.com, including pricing for each supported order type. All prices are in US Dollars (USD) and apply to non-premium domains. name.com provides three pricing types for each TLD:

• Account-Level Pricing - Your price, including any applicable rebates, promotions, or account-level discounts. This is referenced as ‘registrationprice’, ‘renewalprice’, ‘transferinprice’ and ‘domainrestorationprice’ in this endpoint.
• Original Pricing (No Discounts Applied) - The suggested retail price (MSRP) before any discounts are applied.
• Retail Pricing (Public Site Pricing) - The current public retail price on name.com, including any public rebates or promotions, but before any account-level discounts.

Important Notes:

• Promo codes are not supported through the API, and therefore are not reflected in any pricing values returned.
• General TLD pricing only: This represents standard pricing for domains registered under the specified TLD. Pricing for specific domains may differ based on multiple factors (e.g., premium classifications, registry pricing rules). To retrieve pricing for an individual domain, use the GetPricingForDomain endpoint.
• Availability: If a pricing value is returned as null, that product type is not currently supported for the TLD. (Example: registrationPrice = null means registrations are not currently available.)
• If you do not have account level pricing, the retail price will always match your account level price. (e.g., registration price = registration retail price)

GET /core/v1/tldpricing

TLD Price List

cURL

curl --request GET \
  --url https://api.dev.name.com/core/v1/tldpricing \
  --header 'Authorization: Basic <encoded-value>'

200

{
  "lastPage": 123,
  "nextPage": 123,
  "totalCount": 123,
  "from": 123,
  "to": 123,
  "pricing": [
    {
      "tld": "com",
      "duration": 1,
      "registrationPrice": 9.99,
      "registrationRetailPrice": 10.99,
      "registrationOriginalPrice": 11.99,
      "renewalPrice": 9.99,
      "renewalRetailPrice": 10.99,
      "renewalOriginalPrice": 11.99,
      "domainRestorationPrice": 120.99,
      "domainRestorationRetailPrice": 130.99,
      "domainRestorationOriginalPrice": 140.99,
      "transferInPrice": 19.99,
      "transferInRetailPrice": 20.99,
      "transferInOriginalPrice": 21.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.

Query Parameters

perPage · integer<int32> · default: 25

Per Page is the number of records to return per request. Per Page defaults to 25.

page · integer<int32> · default: 1

Page is which page to return.

duration · integer<int32> · default: 5

The number of years to get pricing for. The requested duration must be between 1 and 10 (inclusive). If the duration is not passed in the request, it will default to 1.

Required range: 1 <= x <= 10

Example:

1

tlds · string[]

A list of specific TLDs to get pricing for. Maximum of 25 TLDs can be requested at a time. When querying for IDN TLDs, due to character restrictions within a URL, they must be submitted in ASCII format. This means using "xn--9dbq2a" as opposed to it's unicode equivalent. The submitted TLDs will be checked for validity and support at name.com, and any invalid TLD will be removed from the submitted list. If all submitted TLDs are invalid or not supported by name.com, this will be considered a bad request, and a 400 Bad Request will be returned with an appropriate message.

Required array length: 1 - 25 elements

Example:

["com", "net", "org"]

Response

200

application/json

A successful response.

lastPage · integer<int32> · required

LastPage is the identifier for the final page of results. It is only populated if there is another page of results after the current page.

nextPage · integer<int32> | null · required

NextPage is the identifier for the next page of results. It is only populated if there is another page of results after the current page.

totalCount · integer<int32> · required

TotalCount is total number of results.

from · integer<int32> · required

From specifies starting record number on current page.

to · integer<int32> · required

To specifies ending record number on current page.

pricing · object[] · required

Show child attributes