CentralNic Reseller Homepage
CentralNic Reseller Homepage


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)
command         = AddDomain
domain          = yourdomain.ltd
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0	= (NAMESERVER)
nameserver1 	= (NAMESERVER)

After a successful registration of the domain, it will be transfer locked from the registry for a period of 60 days.

Domain Modification

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

Domain Renewal

(API Command reference » RenewDomain)
command    = RenewDomain
domain     = yourdomain.ltd
period     = (INT)
expiration = (INT)

Domain Deletion

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

Domain Transfer

(API Command reference » TransferDomain)
command = TransferDomain
domain = yourdomain.ltd
action = REQUEST
auth = (TEXT)

Transfer procedure

  • The transfer is submitted to the registry and the losing registrar is automatically notified by them.
  • The losing registrar sends an email to the owner (and optionally admin) contact, informing about the transfer; this may include options to approve and/or deny the transfer. If neither explicitly approved nor denied, the transfer will be automatically finalized after 5 days.

Transfer notes

  • A .ltd domain transfer must be initiated with a so-called authorisation code, (auth-code) which can be obtained from the current registrar through the owner/admin contact of the domain.
  • Ensure that your respective domain does not have a lock-status (clientTransferProhibited and/or serverTransferProhibited). This can be seen in WHOIS.
  • If the domain has a client-side transfer lock, the owner can ask the current registrar to have the lock removed.
  • These procedures only apply for domain transfers between registrars. For internal transfers between resellers, please consult our documentation about internal transfers/usertransfers.


The format for auth info requires a minimum length of 8 characters and a maximum length of 32 characters.

Additionally, auth info must contain at least one of each of the following three character types:

  • Alphabetic characters: a-z; A-Z
  • Numeric characters: 0-9
  • Special characters: !;<=$%?&@[()]*^+-,'-{.|/}:~

Domain Restore

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

Domain Extensions

X-ALLOCATION-TOKENProvide a token that has to be issued by the registry for the registration of a premium domain name.

Domain Restrictions

Donuts registry: Extended validation according to the OFAC list

"A new validation has been added to the pages of the portal where the user introduces the state or province in a postal address, for example creating a contact. This new feature validates if the state/province is included in OFAC list from the United States Government. In that case the operation will not be allowed and the system will return a message informing that the registry cannot provide services to individuals/entities based in countries that are sanctioned by the government of the USA.

The validation will be by country and state/province which means the state/province plus the country set by the user should match with one of the combinations of the OFAC list. These are some examples related to the current situation in Crimea Peninsula:

  • State/Province: Crimea - Country: Ukraine - Result: Not allowed
  • State/Province: Crimea - Country: Russian Federation - Result: Not allowed
  • State/Province: Crimea - Country: United States - Result: Successful

This addition complements the existing functionality which validates if the entered country is in the OFAC list."

Allocation token: Override feature for reserved domains

When the sale of a Donuts domain is made directly to a registrant (for example via pioneer programs), the domain name is kept in a reserved state (by Donuts) until the registrant is able to register the domain name through their preferred registrar. In this context Donuts launched the reserved domain override feature called "allocation token". The feature allows Donuts operations staff to assign an override token to a domain name. Donuts then provides this token to the registrant. The registrant uses the token during the registration process to override the reserved status, which allows the allocation of the domain name to proceed.

Supported IDN Scripts

The following IDN scripts are supported by .ltd.
Provide the LANGUAGE TAG corresponding to your desired IDN within the AddDomain command as X-IDN-LANGUAGE extension.


Get more information of "IDN tables", which represent permitted code points (letters) allowed for Internationalised Domain Name registrations in particular registries on IANA Repository of IDN Practices.

We domains