---
title: "List TLDs with their cheapest prices"
method: GET
path: "/api/v1/tlds"
tags: ["TLDs"]
---

# List TLDs with their cheapest prices

`GET /api/v1/tlds`

## Request

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

## Query parameters

- `type` string
- `category` string
- `q` string
- `sort` 'popularity' | 'price_asc' | 'price_desc' | 'tld'
- `limit` integer
- `offset` integer

## Response `200`

OK

- object
  - `data` TldListItem[]
    - `id` string
    - `tld` string
    - `type` string
    - `category` string[]
    - `isRestricted` boolean
    - `popularityRank` integer
    - `cheapestRegister` object, nullable
      - `price` number
      - `registrar` RegistrarRef
        - `name` string
        - `slug` string
    - `cheapestRenew` object, nullable
      - `price` number
      - `registrar` RegistrarRef
        - `name` string
        - `slug` string
    - `cheapestTransfer` object, nullable
      - `price` number
      - `registrar` RegistrarRef
        - `name` string
        - `slug` string
    - `cheapestThreeYear` object, nullable: Register + 2× renew at a single registrar
      - `price` number
      - `registrar` RegistrarRef
        - `name` string
        - `slug` string
    - `registrarCount` integer
  - `meta` object
    - `total` integer
    - `limit` integer
    - `offset` integer

## 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)
- `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)