Skip to main content
GET
/
core
/
v1
/
tldpricing
TLD Price List
curl --request GET \
  --url https://api.dev.name.com/core/v1/tldpricing \
  --header 'Authorization: Basic <encoded-value>'
{
  "lastPage": 123,
  "nextPage": 123,
  "totalCount": 123,
  "from": 123,
  "to": 123,
  "pricing": [
    {
      "tld": "com",
      "duration": 1,
      "registrationPrice": 9.99,
      "registrationOriginalPrice": 11.99,
      "renewalPrice": 9.99,
      "domainRestorationPrice": 120.99,
      "transferInPrice": 19.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
default:25

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

​
page
integer
default:1

Page is which page to return.

​
duration
number
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

A successful response.

​
lastPage
integer
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 | 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
required

TotalCount is total number of results.

​
from
integer
required

From specifies starting record number on current page.

​
to
integer
required

To specifies ending record number on current page.

​
pricing
object[]
required
⌘I