# TLD Price List

Get an alphabetical pricing list of all TLDs supported by name.com. The pricing returned will be your account level price in US Dollars (USD) and is the price you pay for non-premium registrations.

 This is general pricing for domains registered with the specified TLD. Individual domains may have different pricing based on a large number of factors.
If you are trying to see pricing for a specific individual domain, you will need to use the GetPricingForDomain endpoint..

Please note that if  is returned for any of the prices, it means that particular product is unavailable at name.com at the time of the request.
For example, if  returns as  in the response, it means that name.com is not currently accepting registrations for that TLD.

Any IDN TLDs will return in their unicode format.


Endpoint: GET /core/v1/tldpricing
Version: 1.3.1
Security: BasicAuth

## Query parameters:

  - `perPage` (integer)
    Per Page is the number of records to return per request. Per Page defaults to 25.

  - `page` (integer)
    Page is which page to return.

  - `duration` (number)
    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.
    Example: 1

  - `tlds` (array)
    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  will be returned with an appropriate message.
    Example: ["com","net","org"]

## Response 200 fields (application/json):

  - `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` (array, required)

  - `pricing.tld` (string, required)
    The TLD the pricing applies to. For IDN TLDs, this will be the unicode representation of the TLD.
    Example: "com"

  - `pricing.duration` (number, required)
    The number of years this pricing is for
    Example: 1

  - `pricing.registrationPrice` (number,null, required)
    This your account level price in US Dollars (USD) and is the price you pay for non-premium registrations. It includes applicable rebates, promotions and/or sales.
    Example: 9.99

  - `pricing.registrationOriginalPrice` (number,null, required)
    Price in US Dollars (USD) before any rebates, promotions and/or sales when registering non-premium domains.
    Example: 11.99

  - `pricing.renewalPrice` (number,null, required)
    This your account level price in US Dollars (USD) and is the price you pay for renewals. It includes applicable rebates, promotions and/or sales.
    Example: 9.99

  - `pricing.domainRestorationPrice` (number,null, required)
    This your account level price in US Dollars (USD) and is the price you pay for domain restorations. It includes applicable rebates, promotions and/or sales.
    Example: 120.99

  - `pricing.transferInPrice` (number,null, required)
    This your account level price in US Dollars (USD) and is the price you pay for transferring a domain to management at name.com. It includes applicable rebates, promotions and/or sales.
    Example: 19.99

## Response 429 fields (application/json):

  - `message` (string)
    A human-readable message providing more details about the error
    Example: "Rate Limit Exceeded"

## Response 500 fields (application/json):

  - `message` (string, required)
    A human-readable message providing more details about the error.
    Example: "Internal Server Error"

  - `details` (string,null)
    Additional context or information about the error.
    Example: "Something went wrong."