---
title: "List TLD pricing"
method: GET
path: "/pricing/dns/tlds"
tags: ["pricing"]
---

# List TLD pricing

`GET /pricing/dns/tlds`

## Request

- Base URL: `https://api.unstoppabledomains.com/partner/v3`
- URL: `https://api.unstoppabledomains.com/partner/v3/pricing/dns/tlds`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/unstoppabledomains/apis/reseller-api/docs/pricing/dns/tlds/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieve pricing information for all available TLDs, including registration, renewal, transfer, and restoration costs.

## Response `200`

List of TLD pricing

- TldDnsPricingListResponse
  - `@type` 'unstoppabledomains.com/partner.v3.List', required
  - `items` TldDnsPricingResponse[], required
    - `@type` 'unstoppabledomains.com/partner.v3.TldDnsPricing', required
    - `name` string, required
    - `registration` DomainPriceResponse
      - `type` 'STANDARD' | 'PREMIUM' | 'DEFERRED', required
      - `listPrice` PriceItemResponse, required
        - `usdCents` number, required
      - `adjustments` DomainPriceAdjustmentResponse[]
        - `usdCents` number, required
        - `type` string, required
      - `subTotal` PriceItemResponse, required
        - `usdCents` number, required
      - `validUntilTimestamp` number
    - `renewal` DomainPriceResponse
      - `type` 'STANDARD' | 'PREMIUM' | 'DEFERRED', required
      - `listPrice` PriceItemResponse, required
        - `usdCents` number, required
      - `adjustments` DomainPriceAdjustmentResponse[]
        - `usdCents` number, required
        - `type` string, required
      - `subTotal` PriceItemResponse, required
        - `usdCents` number, required
      - `validUntilTimestamp` number
    - `transfer` DomainPriceResponse
      - `type` 'STANDARD' | 'PREMIUM' | 'DEFERRED', required
      - `listPrice` PriceItemResponse, required
        - `usdCents` number, required
      - `adjustments` DomainPriceAdjustmentResponse[]
        - `usdCents` number, required
        - `type` string, required
      - `subTotal` PriceItemResponse, required
        - `usdCents` number, required
      - `validUntilTimestamp` number
    - `restoration` DomainPriceResponse
      - `type` 'STANDARD' | 'PREMIUM' | 'DEFERRED', required
      - `listPrice` PriceItemResponse, required
        - `usdCents` number, required
      - `adjustments` DomainPriceAdjustmentResponse[]
        - `usdCents` number, required
        - `type` string, required
      - `subTotal` PriceItemResponse, required
        - `usdCents` number, required
      - `validUntilTimestamp` number
    - `constraints` DomainAvailabilityConstraintsResponse
      - `registration` DomainAvailabilityRegistrationConstraintsResponse
        - `period` IcannDomainRenewalInfoPeriodResponse, required
          - `min` number, required
          - `max` number, required
          - `increments` number, required

## Other responses

- `401`: Authentication required
- `403`: Insufficient permissions
- `500`: Internal server error

## Changes

- **2026-02-27** `64f751be432d`: 3 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `403`
  - added the non-success response with the status `500`

[Operation history](https://skmtc.dev/unstoppabledomains/apis/reseller-api/changes/pricing/dns/tlds/get.md)

---

[API](https://skmtc.dev/unstoppabledomains/apis/reseller-api.md) - [All operations](https://skmtc.dev/unstoppabledomains/apis/reseller-api/llms.txt) - [OpenAPI document](https://skmtc.dev/unstoppabledomains/apis/reseller-api/revisions/e0ac88d02fe7?raw)