---
title: "List TLDs"
method: GET
path: "/tlds"
tags: ["tlds"]
---

# List TLDs

`GET /tlds`

Lists TLDs supported for registration or transfer.

## Query parameters

- `sort` 'tld:asc' | 'tld:desc'

## Response `200`

Successfully retrieved the TLDs.

- object
  - `data` TLD[]
    - `tld` string — The registerable suffix. In most cases the suffix matches a TLD, but there are some cases where the suffix is a subzone of the TLD (e.g. com.au).
    - `tld_type` 1 | 2 | 3 — TLD types are: * 1 - gTLD (global TLD) * 2 - ccTLD (country-code TLD) * 3 - newTLD (new global TLD)
    - `whois_privacy` boolean — true if the suffix allows WHOIS privacy as a separate component. Some registries may provide WHOIS privacy at registry level by limiting the visibility of certain attributes in the WHOIS response.
    - `auto_renew_only` boolean — true if the suffix requires auto-renewal and can't be renewed manually
    - `idn` boolean — true if the suffix supports Internationalized Domain Names (IDN)
    - `minimum_registration` integer
    - `registration_enabled` boolean — true if DNSimple supports registrations for this TLD
    - `renewal_enabled` boolean — true if DNSimple supports renewals for this TLD
    - `transfer_enabled` boolean — true if DNSimple supports inbound transfers for this TLD
    - `dnssec_interface_type` 'ds' | 'key' — type of data interface required for DNSSEC
  - `pagination` Pagination
    - `current_page` integer
    - `per_page` integer
    - `total_entries` integer
    - `total_pages` integer

## Changes

- **2023-07-18** (v2) `c8591dcf8c29` — 20 breaking
  - the response property `data` became optional for the status `200`
  - the response property `data/items/auto_renew_only` became optional for the status `200`
  - the response property `data/items/dnssec_interface_type` became optional for the status `200`
  - the response property `data/items/idn` became optional for the status `200`
  - …16 more

[Change history](https://skmtc.dev/dnsimple/apis/dnsimple-api/changes/tlds/get.md)

---

[API](https://skmtc.dev/dnsimple/apis/dnsimple-api.md) · [All operations](https://skmtc.dev/dnsimple/apis/dnsimple-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/dnsimple/dnsimple-api/revisions/2e2a96fa71fe/schema)