--- title: "TLD Price List" method: GET path: "/core/v1/tldpricing" tags: ["TLD Pricing"] --- # TLD Price List `GET /core/v1/tldpricing` 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) ## Query parameters - `perPage` integer — Maximum number of records to return per page for paginated list endpoints. - `page` integer - `duration` integer - `tlds` string[] ## Response `200` A successful response. - TldPriceListResponse - `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, nullable, 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` TldPriceListEntry[], required - `tld` string, required — The TLD the pricing applies to. For IDN TLDs, this will be the unicode representation of the TLD. - `duration` integer, required — The number of years this pricing is for - `registrationPrice` number, double, nullable, required — This is 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 account-level discounts. - `registrationRetailPrice` number, double, nullable, required — This is the current retail price on name.com in US Dollars (USD) after including rebates, promotions and/or sales for registering non-premium domains. - `registrationOriginalPrice` number, double, nullable, required — This is name.com's suggested retail price (MSRP) in US Dollars (USD) before any discounts for registering non-premium domains. - `renewalPrice` number, double, nullable, required — This is your account level price in US Dollars (USD) and is the price you pay for non-premium renewals. It includes applicable rebates, promotions and/or account-level discounts. - `renewalRetailPrice` number, double, nullable, required — This is the current retail price on name.com in US Dollars (USD) after including rebates, promotions and/or sales for renewals of non-premium domains. - `renewalOriginalPrice` number, double, nullable, required — This is name.com's suggested retail price (MSRP) in US Dollars (USD) before any discounts for renewals of non-premium domains. - `domainRestorationPrice` number, double, nullable, required — This is your account level price in US Dollars (USD) and is the price you pay for non-premium restorations. It includes applicable rebates, promotions and/or account-level discounts. - `domainRestorationRetailPrice` number, double, nullable, required — This is the current retail price on name.com in US Dollars (USD) after including rebates, promotions and/or sales for restorations of non-premium domains. - `domainRestorationOriginalPrice` number, double, nullable, required — This is name.com's suggested retail price (MSRP) in US Dollars (USD) before any discounts for restoration of non-premium domains. - `transferInPrice` number, double, nullable, required — This is your account level price in US Dollars (USD) and is the price you pay for non-premium transfers. It includes applicable rebates, promotions and/or account-level discounts. - `transferInRetailPrice` number, double, nullable, required — This is the current retail price on name.com in US Dollars (USD) after including rebates, promotions and/or sales for transfers of non-premium domains. - `transferInOriginalPrice` number, double, nullable, required — This is name.com's suggested retail price (MSRP) in US Dollars (USD) before any discounts for transfer of non-premium domains. ## Other responses - `400` — Bad request - Invalid query parameters. - `401` — Unauthorized. - `403` — Forbidden - you do not have permission to perform this action. - `405` — Method not allowed. - `429` — Rate limit has been exceeded. - `500` — Internal server error. - `502` — Bad Gateway - `504` — Gateway Timeout --- [API](https://skmtc.dev/name/apis/name-com-core-api.md) · [All operations](https://skmtc.dev/name/apis/name-com-core-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/name/name-com-core-api/revisions/a37d4cbd3991/schema)