Registration terms: 1 years. Transfers in are supported with an authorisation code. 8 extra registry fields (0 required).
- This extension has extra registry fields — see Extra fields below. Which ones you must send can depend on the value of another field.
At a glance
Section titled “At a glance”| Property | Value |
|---|---|
| Registration terms | 1 years |
| Renewal terms | 1–10 years |
| Transfer in | Supported · authorisation code required · pre-transfer check not available |
| Transfer lock | Can be turned on and off |
| Extra registry fields | 8 — see below |
| Registry documents | Not required |
| Trustee service | Not available |
| WHOIS privacy | Available |
| DNSSEC | Supported |
| IDN (non-ASCII names) | Supported |
| Name servers under the domain | Not allowed |
| Contact change by handle | Available |
| Registry checks name servers | No |
| Test environment | Available |
What each property means and which error you get if you ignore it: TLD catalogue.
Lifecycle
Section titled “Lifecycle”In calendar days. — means the registry does not publish the period.
| Period | Days | What happens |
|---|---|---|
| Add grace | — | Deleting a new registration within this window is refunded. |
| Auto-renew grace | 20 | After expiry the registry renews automatically; a second renewal in this window is refused with 10020. |
| Redemption | 30 | After deletion, POST /api/v1/domains/restore still works. |
| Deletion hold | — | After redemption, before the name is released to the public. Nothing can be done. |
Extra fields (tldAttributes)
Section titled “Extra fields (tldAttributes)”Send these as a flat key/value object named tldAttributes on register requests. See Extra registry fields.
| Key | Required | Type | Description | Allowed values |
|---|---|---|---|---|
X-IT-SECT6-PERSONAL-DATA-FOR-DIFFUSION |
optional | RadioButton | Accept Sect. 6 of registrar contract | Free text |
X-IT-NATIONALITY |
optional | DropdownList | Nationality | HR, DK, CZ, EE, LU, IE, LT, LI, PL, CY, AT, EL, CH, GB, NO, FI, RO, IS, SE, NL, DE, BG, IT, FR, SK, HU, SI, SM, BE, LV, UK, PT, MT, GR, ES, VA |
X-IT-SECT3-LIABILITY |
optional | RadioButton | Accept Sect. 3 of registrar contract | Free text |
X-IT-ENTITY-TYPE |
optional | DropdownList | Entity Type | 4, 1, 6, 7, 2, 5, 3 |
X-IT-CONSENTFORPUBLISHING |
optional | RadioButton | Consent for Publishing | Free text |
X-IT-SECT5-PERSONAL-DATA-FOR-REGISTRATION |
optional | RadioButton | Accept Sect. 5 of registrar contract | Free text |
X-IT-PIN |
optional | Text | Registrant Tax Code | Free text |
X-IT-SECT7-EXPLICIT-ACCEPTANCE |
optional | RadioButton | Accept Sect. 7 of registrar contract | Free text |
Ready-to-send requests
Section titled “Ready-to-send requests”Each request below is built from this extension’s catalogue entry. Replace the domain, the handles and any value in <angle brackets>.
Register
Section titled “Register”POST /api/v1/domains/register with contact handles you created with POST /api/v1/contacts. To send contact details inline instead, use POST /api/v1/domains/register-with-contacts with the same tldAttributes.
tldAttributes lists every field this extension defines. Send the ones that apply: the table above says which are required, and some become required only for a particular value of another field.
{ "domainName": "apiname.co.it", "period": 1, "nameServers": [ "tr.apiname.com", "eu.apiname.com" ], "handles": [ { "contactType": "Registrant", "handle": "D-174829301847" }, { "contactType": "Admin", "handle": "D-174829301847" }, { "contactType": "Tech", "handle": "D-174829301847" }, { "contactType": "Billing", "handle": "D-174829301847" } ], "tldAttributes": { "X-IT-SECT6-PERSONAL-DATA-FOR-DIFFUSION": "<Accept Sect. 6 of registrar contract>", "X-IT-NATIONALITY": "HR", "X-IT-SECT3-LIABILITY": "<Accept Sect. 3 of registrar contract>", "X-IT-ENTITY-TYPE": "4", "X-IT-CONSENTFORPUBLISHING": "<Consent for Publishing>", "X-IT-SECT5-PERSONAL-DATA-FOR-REGISTRATION": "<Accept Sect. 5 of registrar contract>", "X-IT-PIN": "<Registrant Tax Code>", "X-IT-SECT7-EXPLICIT-ACCEPTANCE": "<Accept Sect. 7 of registrar contract>" }}POST /api/v1/domains/renew — call POST /api/v1/domains/renew/check with the same body first. See Renew a domain.
{ "domainName": "apiname.co.it", "period": 1}Transfer in
Section titled “Transfer in”POST /api/v1/domains/transfer. This registry has no pre-transfer check, so call it directly. See Transfer a domain in.
{ "domainName": "apiname.co.it", "authCode": "aB3!xY9-kL2pQ7", "period": 1}From the TLD catalogue on 2026-11-02. For live values call GET /api/v1/products/tlds?filterText=co.it.