---
title: "List the TLDs Domani sells, with pricing"
method: GET
path: "/api/tlds"
tags: ["TLDs"]
---

# List the TLDs Domani sells, with pricing

`GET /api/tlds`

## Request

- Base URL: `https://domani.run`
- URL: `https://domani.run/api/tlds`
- Auth: none required

Returns the TLDs Domani sells, with registration, renewal, and transfer pricing. This is the catalog of our registrars, not every TLD that exists: some root-zone TLDs such as `gov` or `edu` cannot be registered through Domani. Each entry has a `kind`: `tld` (a TLD of the IANA root zone), `second_level` (an offering under one, such as `co.uk`), or `alt_root` (a name outside the root zone, which does not resolve in public DNS). `alt_root` entries are left out unless the `kind` parameter asks for them. Supports filtering by price range, searching by TLD name, sorting, and pagination via `limit`/`offset`. When paginated, includes a `Link` header with the next page URL. **Public endpoint** - no authentication required. Authenticated requests get higher rate limits (60/min vs 30/min).

## Query parameters

- `max_price` number
- `min_price` number
- `sort` 'tld' | 'price' | 'renewal'
- `order` 'asc' | 'desc'
- `search` string
- `limit` integer
- `offset` integer
- `kind` string

## Response `200`

Paginated TLD list with pricing

- object
  - `tlds` TldInfo[]
    - `tld` string, required: Top-level domain without dot prefix
    - `registration` number, required: First-year registration price in USD
    - `renewal` number, required: Annual renewal price in USD
    - `transfer` number, required: Transfer price in USD
    - `kind` 'tld' | 'second_level' | 'alt_root', required: Root-zone kind: `tld` (a TLD of the IANA root zone), `second_level` (an offering under one, such as `co.uk`), or `alt_root` (outside the root zone: does not resolve in public DNS, so search and purchase never offer it)
  - `total` integer: Total matching TLDs (before pagination)
  - `offset` integer
  - `limit` integer, nullable

## Other responses

- `401`: Missing or invalid API key
- `429`: Rate limit exceeded - wait and retry

---

[API](https://skmtc.dev/domani/apis/domani-run-api.md) · [All operations](https://skmtc.dev/domani/apis/domani-run-api/llms.txt) · [OpenAPI document](https://skmtc.dev/domani/apis/domani-run-api/revisions/7679f8159533?raw)