Sign in

v1

latestOpenAPI 3.1.02026-07-2671111437.2 KB
Domain Info

Get TLD Requirements as JSON Schema

Returns the registration requirements as a JSON Schema (Draft 7) document. This endpoint is designed for form generation and validation libraries that consume JSON Schema directly.

get/core/v1/domaininfo/requirementsV2/{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

JSON Schema document describing TLD registration requirements.

$schemastring

The JSON Schema version identifier, should be "http://json-schema.org/draft-07/schema#"

typestring

The JSON Schema type, typically "object" for requirement schemas

titlestring

A human-readable title for the schema

descriptionstring

A detailed description of the registration requirements

requiredstring[]

An array of required property names

allOfobject[]

An array of schema objects that must all be valid. Used for conditional validation with multiple conditions.

ifobject nullable

The condition schema for conditional validation. When this condition is true, the 'then' schema applies.

thenobject nullable

The schema to apply when the 'if' condition is true.

elseobject nullable

The schema to apply when the 'if' condition is false (optional).

Example response

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "title": ".it Domain Registration Requirements Schema",
  "description": "Registration requirements for .it domains",
  "properties": {
    "tldInfo": {
      "tld": ".it",
      "ccTld": true,
      "supportsTransferLock": true,
      "supportsDnssec": true,
      "supportsPremium": false,
      "supportsPrivacy": false,
      "supportsInternalTransfer": true,
      "requiresPreDelegation": false,
      "expirationGracePeriod": 25,
      "allowedRegistrationYears": [
        1,
        3,
        5,
        8,
        10
      ],
      "idnLanguages": {
        "IT": "Italian"
      },
      "hsts": false,
      "minDomainLength": 3,
      "minIdnDomainLength": 5,
      "registryOperator": "nic.it",
      "claimsCheckRequired": [],
      "requireIdnSld": false,
      "readOnly": true
    },
    "contacts": {
      "type": "object",
      "properties": {
        "registrant": {
          "type": "object",
          "properties": {
            "firstName": {
              "type": "string",
              "title": "First Name",
              "description": "First name of registrant contact"
            },
            "email": {
              "type": "string",
              "format": "email",
              "title": "Email",
              "description": "Email address of registrant contact"
            }
          },
          "required": [
            "firstName",
            "email"
          ]
        }
      },
      "required": [
        "registrant"
      ]
    },
    "tldRequirements": {
      "type": "object",
      "properties": {
        "X-IT-ENTITY-TYPE": {
          "type": "string",
          "title": "Registrant Entity Type",
          "enum": [
            "1",
            "2",
            "3",
            "4",
            "5",
            "6",
            "7"
          ]
        },
        "X-IT-PIN": {
          "type": "string",
          "title": ".IT PIN number",
          "description": "16 alphanumeric characters (tax code) for natural persons or 11 digits (VAT number) for organizations"
        }
      }
    }
  },
  "required": [
    "tldInfo",
    "contacts",
    "tldRequirements"
  ]
}