---
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.

---

[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)