.is

API commandsRestrictions

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.

AddDomainModifyDomainRenewDomainDeleteDomainTransferDomainRestoreDomain

Domain Registration

(API Command reference » AddDomain)

Command

command         = AddDomain
domain          = yourdomain.is
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0  = (NAMESERVER)
nameserver1   = (NAMESERVER)

Domain Modification

(API Command reference » ModifyDomain)

Command

command = ModifyDomain
domain  = yourdomain.is

Change of Registrant

• Registrant changes for .is domains can be done via API or webinterface. The expiration date of the domain will not be changed.

Domain Renewal

(API Command reference » RenewDomain)

Command

command    = RenewDomain
domain     = yourdomain.is
period     = (INT)
expiration = (INT)

As .is domains can only be registered on a yearly basis, they cannot be renewed explicitly. To renew a .is 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.is

Domain Transfer

(API Command reference » TransferDomain)

TransferIN

Exception

command = TransferDomain
domain  = yourdomain.is
action  = request

1. The transfer must be requested in our system at first.
2. Then, the .is domain can be pushed from the old registrar to RRPproxy - please set BDB2-IS as Admin & Billingcontact in the ISNIC interface
3. The system will clone the current owner and change the e-mail address to a Key-Systems e-mail address.
4. The registrant must agree to this change by clicking on the confirmation link in the respective e-mail.
5. The process will take approximately 1 hour.

TransferOUT

• It will be possible to initiate a transfer-out with a PushDomain / TransferDomain command.
• The target parameter must be filled with the contact handle of the gaining registrar.
• As soon as the command is sent to the registry, the registrar gets updated (almost in real-time).

Domain Restore

(API Command reference » RestoreDomain)

Command

command = RestoreDomain
domain  = yourdomain.is

.IS domains can be restored up to 30 days after expiration.

Domain Restrictions

• Name servers must be pre-configured and registered with ISNIC
• Following requirements for the name servers are obliged by the registry:
  • The nameservers must be registered with ISNIC.
  • Nameservers must allow connection to UDP port 53, and to TCP port 53 as well (see RFC5966)
  • SOA records must be correctly formatted:
    • Master nameserver correctly named in the MNAME field.
    • Working mailbox of responsible party in RNAME field.
    • Times (refresh, retry and expire) according to RFC1912
  • TTL for NS records not lower than 24 hours.
  • Correct NS records. Properly registered in the appropriate zones, both forward and reverse. I.e. the nameserver’s name must be included in the PTR record set for the nameserver’s IP address.
• Zone check tool is available at https://www.isnic.is/en/host/test
• is registrants may use the RRPproxy nameservers in the future, if they cannot provide their own name servers that meet the requirements of the registry (special configuration, registration of the used name servers at the registry). If the name servers are not configured correctly during domain name registration, the domain will be parked and will remain inactive. An error will occur, if the registrant tries to update a domain with an incorrect name server configuration.
• The usage of a role contact for owner and admin(e.g. Domain Administrator, Hostmaster etc.) is not allowed and will result in the suspension of the domain by ISNIC. in case of an organization, the company name can be splitted and used as first and last name.