CentralNic Reseller Homepage
CentralNic Reseller Homepage

.it

API commands

Please find in the following a set of the most commonly used standard API commands in order to register, modify, renew, and transfer a domain name.

Domain Registration

(API Command reference » AddDomain)
Exception
command = AddDomain
domain = yourdomain.it
period                  = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0	= (NAMESERVER)
nameserver1 	= (NAMESERVER)
X-IT-NATIONALITY 			  = (TEXT) (EU Countrycodes see below)
X-IT-SECT3-LIABILITY                      = 1
X-IT-SECT5-PERSONAL-DATA-FOR-REGISTRATION = 1
X-IT-SECT6-PERSONAL-DATA-FOR-DIFFUSION    = 1
X-IT-SECT7-EXPLICIT-ACCEPTANCE            = 1
X-IT-ENTITY-TYPE                        = 1-7 (not necessary if X-IT-ACCEPT-TRUSTEE-TAC = 1)
X-IT-PIN                 = (TEXT)(not necessary if X-IT-ACCEPT-TRUSTEE-TAC = 1)
X-IT-ACCEPT-TRUSTEE-TAC                   = 0|1
X-IT-CONSENTFORPUBLISHING	= 0|1
auth                                      = (TEXT)

The owner contact of the domain registration must be inside the European Union(or any of the allowed countries; for details see tab "Restrictions"). If there is no eligible contact available you can use our Trustee Service(X-IT-ACCEPT-TRUSTEE-TAC = 1) which offers such a contact. If you are choosing the trustee solution, then the registration will NOT be processed in realtime because of the verification procedure of our Trustee Service, which can take up to 3 days.

  • Due to changes in the registration policy, X-IT-CONSENTFORPUBLISHING = 0 is only allowed, if X-IT-ENTITY-TYPE = 1
    • X-IT-CONSENTFORPUBLISHING = 0 will be used by default for X-IT-ENTITY-TYPE = 1; for all other entity types(2-7) it is mandatory to explicitly submit X-IT-CONSENTFORPUBLISHING = 1
  • List of valid EU countrycodes: AT BE BG CY CZ DK DE EE EL ES FI FR GB UK HU IE IT LT LU LV MT NL PL PT RO SE SI SK IS LI NO SM VA CH GR HR

Domain Modification

(API Command reference » ModifyDomain)
Standard command
command = ModifyDomain
domain  = yourdomain.it

Owner and admin contact cannot be changed at the same time. Please first change the owner and then admin contact in a second ModifyDomain command.

Change of registrant

Exception
command                                   = TradeDomain
domain                                    = yourdomain.it
OWNERCONTACT0                             = (CONTACT)
X-IT-NATIONALITY 			  = (TEXT) (EU Countrycodes see below)
X-IT-SECT3-LIABILITY                      = 1
X-IT-SECT5-PERSONAL-DATA-FOR-REGISTRATION = 1
X-IT-SECT6-PERSONAL-DATA-FOR-DIFFUSION    = 1
X-IT-SECT7-EXPLICIT-ACCEPTANCE            = 1
X-IT-ENTITY-TYPE                        = 1-7 (not necessary if X-IT-ACCEPT-TRUSTEE-TAC = 1)
X-IT-PIN                 = (TEXT) (not necessary if X-IT-ACCEPT-TRUSTEE-TAC = 1)
X-IT-ACCEPT-TRUSTEE-TAC                   = 0|1
X-IT-CONSENTFORPUBLISHING	= 0|1
auth                                      = (TEXT)

A change of registrant also requires (as for a new domain registration) the agreement to the .it registration conditions. Therefore you have to agree to and set the following parameters:

  • X-IT-SECT3-LIABILITY = 1
  • X-IT-SECT5-PERSONAL-DATA-FOR-REGISTRATION = 1
  • X-IT-SECT6-PERSONAL-DATA-FOR-DIFFUSION = 1
  • X-IT-SECT7-EXPLICIT-ACCEPTANCE = 1

additionally to the registrant related extensions(not necessary if X-IT-ACCEPT-TRUSTEE-TAC = 1):

  • X-IT-ENTITY-TYPE = 1-7
  • X-IT-PIN = (TEXT)
  • X-IT-CONSENTFORPUBLISHING = 0|1 while 0 is only allowed for X-IT-ENTITY-TYPE = 1

Domain Renewal

RenewDomain is not available for .it TLDs.

As .it domains can only be registered on a yearly basis, they cannot be renewed explicitly. To renew a .it domain you have to set the domain renewal mode or default renewal mode to AUTORENEW or RENEWONCE.

Domain Deletion

(API Command reference » DeleteDomain)
Command
COMMAND = DeleteDomain
DOMAIN = yourdomain.it

Domain Transfer

(API Command reference » TransferDomain)
Standard command
command = TransferDomain
domain = yourdomain.it
action = REQUEST
auth = (TEXT)
  • A .it domain transfer has to be initiated with a so-called authorisation code, which can be obtained from the current registrar through the owner or Admin-C of the domain.
  • The losing registrar has 5 days to approve and/or reject the transfer request. At the end of the pendingTransfer period, requests that have not been explicitly cancelled, rejected or approved are approved automatically by the registry.
  • After a successful transfer, the expiration date changes to the date of the conclusion of the transfer operation + 1 year.

Transfer with change of registrant

Exception
command                                   = TransferDomain
domain                                    = yourdomain.it
OWNERCONTACT0                             = (CONTACT)
X-IT-SECT3-LIABILITY                      = 1
X-IT-SECT5-PERSONAL-DATA-FOR-REGISTRATION = 1
X-IT-SECT6-PERSONAL-DATA-FOR-DIFFUSION    = 1
X-IT-SECT7-EXPLICIT-ACCEPTANCE            = 1
X-IT-ENTITY-TYPE                        = 1-7
X-IT-PIN                 = (TEXT)
X-IT-ACCEPT-TRUSTEE-TAC                   = 0|1
auth                                      = .......

Domain Restore

(API Command reference » RestoreDomain)
Command
command = RestoreDomain
domain  = yourdomain.it

Domain Extensions

X-IT-ACCEPT-TRUSTEE-TAC0|1

The Ownercontact of the domain registration must be inside the European Union. If there is no eligible contact available you can use our Trustee Service which offers such a contact.
X-IT-CONSENTFORPUBLISHING0|1

Value to allow the publication of contact's personal data
0 deny publication; only possible if X-IT-ENTITY-TYPE is 1
1 allow publication; mandatory default for all other entity types
X-IT-ENTITY-TYPE1-7

Numeric value to identify Registrant typology (only optional when the trustee is used)

If no entity type has been entered then it is depending on the owner handle:
* if a company is inserted and the country code is IT the entity type 2 must be used
* if a company is inserted and the country code is not IT the entity type 7 must be used
* if no company is inserted the entity type 1 will be used

Allowed values:

1 Italian and foreign natural persons
2 Companies/one man companies (only IT)
3 Freelance workers/professionals (only IT)
4 non-profit organizations(only IT)
5 public organizations (only IT)
6 other subjects (only IT)
7 foreigner companies/organizations who match 2-6 (all other EU member countries)
X-IT-NATIONALITYList of country codes: AT BE BG CY CZ DK DE EE EL ES FI FR GB UK HU IE IT LT LU LV MT NL PL PT RO SE SI SK IS LI NO SM VA CH GR HR
X-IT-PINDomain name registrant's Taxcode (mandatory / only optional when the trustee is used)

If the requester:
* is an Italian natural person it contains his/her Codice Fiscale (16 characters format).
* For others than residents of IT it can contain a document number. (ID Card).
* For associations without VAT number and tax code must be equal to n.a..
* In all other cases it must be equal to VAT number (in the 16 characters format if nationality is IT) or the numeric Codice Fiscale.
X-IT-SECT3-LIABILITY0|1

The Registrant of the domain name in question, declares under their own responsibility that they are:

a) in possession of the citizenship or resident in a country belonging to the European Union (in the case of registration for natural persons);

b) established in a country belonging to the European Union (in the case of registration for other organizations);

c) aware and accept that the registration and management of a domain name is subject to the "Rules of assignment and management of domain names in ccTLD. it" and "Regulations for the resolution of disputes in the ccTLD.it" and their subsequent amendments;

d) entitled to the use and/or legal availability of the domain name applied for, and that they do not prejudice, with the request for registration, the rights of others;

e) aware that for the inclusion of personal data in the Database of assigned domain names, and their possible dissemination and accessibility via the Internet, consent must be given explicitly by ticking the appropriate boxes in the information below. See "The policy of the .it Registry in the Whois Database" on the website of the Registry (http://www.nic.it);

f) aware and agree that in the case of erroneous or false declarations in this request, the Registry shall immediately revoke the domain name, or proceed with other legal actions. In such case the revocation shall not in any way give rise to claims against the Registry;

g) release the Registry from any liability resulting from the assignment and use of the domain name by the natural person that has made the request;

h) accept Italian jurisdiction and laws of the Italian State.
X-IT-SECT5-PERSONAL-DATA-FOR-REGISTRATION0|1

The interested party, after reading the above disclosure, gives consent to the processing of information required for registration, as defined in the above disclosure. Giving consent is optional, but if no consent is given, it will not be possible to finalize the registration, assignment and management of the domain name.
X-IT-SECT6-PERSONAL-DATA-FOR-DIFFUSION0|1

The interested party, after reading the above disclosure, gives consent to the dissemination and accessibility via the Internet, as defined in the disclosure above. Giving consent is optional, but absence of consent does not allow the dissemination and accessibility of Internet data.
X-IT-SECT7-EXPLICIT-ACCEPTANCE0|1

For explicit acceptance, the interested party declares that they:

c) are aware and agree that the registration and management of a domain name is subject to the "Rules of assignment and management of domain names in ccTLD.it" and "Regulations for the resolution of disputes in the ccTLD.it "and their subsequent amendments;

f) are aware and agree that in the case of erroneous or false declarations in this request, the Registry shall immediately revoke the domain name, or proceed with other legal actions. In such case the revocation shall not in any way give rise to claims against the Registry;

g) release the Registry from any liability resulting from the assignment and use of the domain name by the natural person that has made the request;

h) accept the Italian jurisdiction and laws of the Italian State.

Domain Restrictions

  • Only individual and juridical persons residing in or belonging to the following EU Member State (plus Vatican City, the Republic of San Marino, the Swiss Confederation and in the United Kingdom) can register domain names under the ccTLD .it:
    • Austria
    • Belgium
    • Bulgaria
    • Croatia
    • Cyprus
    • Czech Republic
    • Denmark
    • Estonia
    • Finland
    • France
    • Germany
    • Greece
    • Hungary
    • Iceland
    • Ireland
    • Italy
    • Latvia
    • Liechtenstein
    • Lithuania
    • Luxembourg
    • Malta
    • Netherlands
    • Norway
    • Poland
    • Portugal
    • Romania
    • San Marino
    • Slovakia
    • Slovenia
    • Spain
    • Sweden
    • Switzerland
    • United Kingdom
    • Vatican City
    • All others can use our trustee service to register a .it domain.
  • Contact handles with country code "IT" have to contain the 2digit ISO code (ISO_3166-2:IT) which defines codes for the names of the principal subdivisions in Italy.
  • Name servers for a .it domain have to be correctly configured before the actual registration. The registry checks the name servers for a period of 30 days, else the registration will fail and the domain will be deleted.
    • Please check that the following requirements are met:
    • The master server stated in the SOA of the zone must be one of the nameservers given with the domain application.
    • Each nameserver stated in the application must have a valid NS entry.
    • Check your name server configuration at the registry

We domains
-