v1

latestOpenAPI 3.1.02026-07-2671111437.2 KB
Domain Info

Get Specific TLD Requirements

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

get/core/v1/domaininfo/requirements/{tld}

Path parameters

tldstring required
Example:fr

TLD indicates which domain requirements to retrieve (without the dot prefix, e.g., 'fr' for .fr domains). For punycode TLDs, use the ASCII version instead of the UTF-8. So for the онлайн TLD, you would submit xn--80asehdb.

Response

The complete registration requirements for the specified TLD.

Example response

{
  "tldInfo": {
    "tld": ".fr",
    "ccTld": true,
    "supportsTransferLock": true,
    "supportsDnssec": true,
    "supportsPremium": true,
    "supportsPrivacy": true,
    "supportsInternalTransfer": true,
    "requiresPreDelegation": true,
    "expirationGracePeriod": 25,
    "allowedRegistrationYears": [
      1,
      3,
      5,
      8,
      10
    ],
    "idnLanguages": {
      "DE": "German",
      "DK": "Danish",
      "ES": "Spanish",
      "IT": "Italian",
      "JP": "Japanese"
    },
    "hsts": true,
    "minDomainLength": 3,
    "minIdnDomainLength": 5,
    "registryOperator": "verisign",
    "claimsCheckRequired": [
      "registration"
    ]
  },
  "contacts": {
    "description": "The contacts required to be submitted for registration",
    "type": "string",
    "required": true,
    "label": "contacts"
  },
  "requirements": {
    "description": "Required fields to register an .fr domain"
  }
}