---
title: "Get Specific TLD Requirements"
method: GET
path: "/core/v1/domaininfo/requirements/{tld}"
tags: ["Domain Info"]
---

# Get Specific TLD Requirements

`GET /core/v1/domaininfo/requirements/{tld}`

Returns the registration requirements some general information for a specific TLD. The response contains a detailed description of eligibility criteria and a fields object with all required and optional fields, including validation rules, conditional logic, and nested field structures. Provide the TLD as a path parameter to retrieve its complete registration requirements. Useful when you only need details for one TLD (e.g., when a user selects .fr from a dropdown).

## Path parameters

- `tld` string, required

## Response `200`

The complete registration requirements for the specified TLD.

- GetRequirementResponse — GetRequirementResponse has TLD Info and registration requirements for the specified TLD. The requirements field will always be present but may be an empty object when no specific requirements exist for the TLD.
  - `tldInfo` ResellerTldInfo, required — General information about a TLD and it's various requirements. This is not a comprehensive list of all information related to a TLD.
    - `tld` string, required — The TLD this information relates to.
    - `ccTld` boolean, required — Whether the TLD is a Country Code TLD.
    - `supportsTransferLock` boolean, required — Whether the TLD supports implementing a Transfer Lock.
    - `supportsDnssec` boolean, required — Whether the TLD supports DNSSEC.
    - `supportsPremium` boolean, required — Whether there are premium domains for this TLD.
    - `supportsPrivacy` boolean, required — Whether the TLD supports WHOIS Privacy.
    - `supportsInternalTransfer` boolean, required — Whether the TLD supports internal transfer between reseller accounts.
    - `requiresPreDelegation` boolean, required — Whether this TLD requires pre-delegation. If this is true, these domains must be added to the name servers before the domain creation is completed.
    - `expirationGracePeriod` integer, required — The number of days you have to renew your domain after it has expired, but before it is removed from your account.
    - `allowedRegistrationYears` integer[], required — The years that a domain is allowed to be registered for.
    - `idnLanguages` object, required — The IND Languages that the TLD supports (if any).
    - `hsts` boolean, required — The entire TLD namespace has been added to the HSTS Preload list. As such, all second-level domains under .TLD will only load on modern browsers if a valid SSL certificate has been configured and the webserver is serving HTTPS.
    - `minDomainLength` integer, required — The minimum allowed length for the second level domain (SLD) for a given TLD. The SLD would be the `example` part of `example.com`. Attempts to register a domain with a shorter length than allowed will result in a failure of a Create Domain request.
    - `minIdnDomainLength` integer, nullable, required — The minimum allowed length for the second level domain (SLD) that utilizes an IDN character for a given TLD. The SLD would be the `èxample` part of `èxample.com`. Attempts to register a domain with a shorter length than allowed will result in a failure of a Create Domain request. This value will often be different from the `minDomainLength` for non-IDN registrations. This parameter will return as `null` for any TLDs that do not support IDN registrations.
    - `registryOperator` string, required — The registry that operates the given TLD.
    - `claimsCheckRequired` string[], required — Array of valid purchase types if claims check is required for this TLD for current date/time. If claims checking is required, returns an array of valid purchase types (e.g., ["registration", "landrush_eap"]). If claims checking is not required, returns an empty array [].
    - `requireIdnSld` boolean, required — When true, the TLD only accepts IDN (punycode) second-level domain names in the required script. ASCII/Latin SLDs are not valid for registration.
  - `contacts` ContactsRequirement, required — ContactsRequirement defines the registration requirements for contact fields for a specific TLD, including required fields, validation rules, and conditional logic. This follows the RequirementField structure with contact roles as nested fields.
    - `description` string — A detailed description of the contact requirements for this TLD, including eligibility criteria, restrictions, and important notes.
    - `type` string, required — The requirement type, which will be "string" for contacts.
    - `required` union, required — Whether contact information is mandatory for domain registration.
      - boolean
      - string
    - `label` string — A user-friendly label for the contacts field.
    - `fields` object — An object containing contact roles (registrant, tech, admin, etc.) with their individual field requirements.
  - `requirements` Requirement, required — Requirement defines the registration requirements for a specific TLD, including required fields, validation rules, and conditional logic.
    - `description` string — A detailed description of the registration requirements for this TLD, including eligibility criteria, restrictions, and important notes.
    - `fields` object — An object containing all required and optional fields for domain registration, with their validation rules and conditional logic.

## Other responses

- `400` — Bad request - Invalid TLD format.
- `401` — Unauthorized.
- `403` — Forbidden - you do not have permission to perform this action.
- `404` — Tld not found.
- `405` — Method not allowed.
- `422` — TLD not supported.
- `429` — Rate limit has been exceeded.
- `500` — Internal server error.
- `502` — Bad Gateway
- `504` — Gateway Timeout

---

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