---
title: "Every registrar’s current price for one TLD"
method: GET
path: "/api/v1/tlds/{tld}"
tags: ["TLDs"]
---

# Every registrar’s current price for one TLD

`GET /api/v1/tlds/{tld}`

## Request

- Base URL: `https://www.tlders.com`
- URL: `https://www.tlders.com/api/v1/tlds/{tld}`
- Auth: one of:
  - HTTP bearer
  - API key in header `X-API-Key`

## Path parameters

- `tld` string, required

## Response `200`

OK

- object
  - `data` TldDetail
    - `tld` string
    - `type` string
    - `category` string[]
    - `registryOperator` string
    - `launchDate` string, date-time, nullable
    - `isRestricted` boolean
    - `idnSupported` boolean
    - `dnssecSupported` boolean
    - `currentPrices` TldPrice[]
      - `priceRegister` number: 0 = unknown
      - `priceRenew` number: 0 = unknown
      - `priceTransfer` number: 0 = unknown
      - `currency` string
      - `promoCode` string
      - `fetchedAt` string, date-time
      - `registrar` object
        - `name` string
        - `slug` string
        - `logoUrl` string
        - `whoisPrivacyIncluded` boolean, nullable
    - `priceStats` object, nullable
      - `average` object
        - `register` number, nullable
        - `renew` number, nullable
        - `transfer` number, nullable
      - `median` object
        - `register` number, nullable
        - `renew` number, nullable
        - `transfer` number, nullable

## Other responses

- `400`: A required parameter is missing or invalid
- `401`: Missing, invalid or revoked API key
- `402`: Endpoint needs a paid plan (free keys: 100 requests/month, no bulk /prices)
- `404`: TLD not tracked
- `429`: Daily request limit exceeded (see Retry-After)

---

[API](https://skmtc.dev/tlders/apis/tlders-domain-pricing-api.md) · [All operations](https://skmtc.dev/tlders/apis/tlders-domain-pricing-api/llms.txt) · [OpenAPI document](https://skmtc.dev/tlders/apis/tlders-domain-pricing-api/revisions/d24ebbcf6fd2?raw)