---
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[], required
    - `tld` string, required — 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, required — TLD types are: * 1 - gTLD (global TLD) * 2 - ccTLD (country-code TLD) * 3 - newTLD (new global TLD)
    - `whois_privacy` boolean, required — 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, required — true if the suffix requires auto-renewal and can't be renewed manually
    - `idn` boolean, required — true if the suffix supports Internationalized Domain Names (IDN)
    - `minimum_registration` integer, required
    - `registration_enabled` boolean, required — true if DNSimple supports registrations for this TLD
    - `renewal_enabled` boolean, required — true if DNSimple supports renewals for this TLD
    - `transfer_enabled` boolean, required — true if DNSimple supports inbound transfers for this TLD
    - `dnssec_interface_type` 'ds' | 'key', required — type of data interface required for DNSSEC
    - `name_server_min` integer, required — minimum number of name servers required for this TLD
    - `name_server_max` integer, required — maximum number of name servers allowed for this TLD
    - `trustee_service_enabled` boolean, required — true if trustee service is enabled by default for this TLD
    - `trustee_service_required` boolean, required — true if trustee is required for this TLD
  - `pagination` Pagination, required
    - `current_page` integer, required
    - `per_page` integer, required
    - `total_entries` integer, required
    - `total_pages` integer, required

---

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