---
title: "Get single TLD pricing"
method: GET
path: "/pricing/dns/tlds/{tld}"
tags: ["pricing"]
---

# Get single TLD pricing

`GET /pricing/dns/tlds/{tld}`

## Request

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

Retrieve pricing information for a specific TLD, including registration, renewal, transfer, and restoration costs.

## Path parameters

- `tld` string, required

## Response `200`

TLD pricing details

- TldDnsPricingResponse
  - `@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

- `400`: Invalid request
- `401`: Authentication required
- `403`: Insufficient permissions
- `404`: Resource not found
- `500`: Internal server error

## Changes

- **2026-02-27** `64f751be432d`: 5 info
  - added the non-success response with the status `400`
  - 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 `404`
  - …1 more

[Operation history](https://skmtc.dev/unstoppabledomains/apis/reseller-api/changes/pricing/dns/tlds/:tld/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)