---
title: "Retrieve the TLD"
method: GET
path: "/tlds/{tld}"
tags: ["tlds"]
---

# Retrieve the TLD

`GET /tlds/{tld}`

Retrieves the details of a TLD.

## Path parameters

- `tld` string, required

## Response `200`

Successfully retrieved the TLD details.

- 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

## Other responses

- `404` — The requested resource doesn't exist.

## Changes

- **2026-03-19** (v2) `8f6934d1a399` — 2 info
  - added the required property `data/trustee_service_enabled` to the response with the `200` status
  - added the required property `data/trustee_service_required` to the response with the `200` status
- **2025-07-11** (v2) `06780be0ef17` — 14 info
  - the response property `data` became required for the status `200`
  - the response property `data/auto_renew_only` became required for the status `200`
  - the response property `data/dnssec_interface_type` became required for the status `200`
  - the response property `data/idn` became required for the status `200`
  - …10 more
- **2025-06-13** (v2) `c35ff529d2a2` — 2 info
  - added the optional property `data/name_server_max` to the response with the `200` status
  - added the optional property `data/name_server_min` to the response with the `200` status
- **2023-07-18** (v2) `c8591dcf8c29` — 16 breaking
  - the response property `data` became optional for the status `200`
  - the response property `data/auto_renew_only` became optional for the status `200`
  - the response property `data/dnssec_interface_type` became optional for the status `200`
  - the response property `data/idn` became optional for the status `200`
  - …12 more

[Change history](https://skmtc.dev/dnsimple/apis/dnsimple-api/changes/tlds/:tld/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/270bb4f6f532/schema)