CentralNic Reseller Homepage
CentralNic Reseller Homepage
Overview: List all Top Level Domains

.xxx

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)

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

ACTIVE registration for members of the community

Exception
command            = AddDomain
domain             = yourdomain.xxx
ownercontact0      = (owner handle)
admincontact0      = (admin contact)
techcontact0       = (tech contact)
billingcontact0    = (billing contact)
nameserver0        = (nameserver1)
nameserver1        = (nameserver2)

BLOCKED registration for non members of the community

Exception
command         = AddDomain
domain          = yourdomain.xxx
ownercontact0   = (owner handle)
admincontact0   = (admin contact)
techcontact0    = (tech contact)
billingcontact0 = (billing contact)
nameserver0     = (nameserver1)
nameserver1     = (nameserver2)
X-XXX-DEFENSIVE = 1

Even this is a blocked registration, the nameservers have to be specified.

Domain Modification

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

Change of registrant to a member of the community (Domain active)

Exception
command            = ModifyDomain
domain             = yourdomain.xxx
ownercontact0      = (new owner handle)

Change of registrant to a non member of the community (Domain blocked)

Exception
command         = ModifyDomain
domain          = yourdomain.xxx
ownercontact0   = (new owner handle)
X-XXX-DEFENSIVE = 1

Domain Renewal

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

Domain Deletion

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

Domain Transfer

(API Command reference » TransferDomain)
Command
command = TransferDomain
domain = yourdomain.xxx
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 .xxx 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.

Auth-Codes

The format for auth info requires a minimum length of 6 characters and a maximum length of 16 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
command = RestoreDomain
domain  = yourdomain.xxx

Domain Extensions

X-XXX-DEFENSIVEPerform a defensive registration or set the domain to inactive by setting this value to "1".

Domain Restrictions

  • authcode must have a min. of 6 characters and max. 16 characters
  • If no Extension was submitted with the registration request, the XXX registry will contact the domain holder (eq Owner-C). Therefore, it's important to use good and valid data for the Owner Contact
  • With the ModifyDomain command, it is possible to switch between „Active“ Domain and „blocking“ Domain by using the same extensions as with the domain registration.

Supported IDN Scripts

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

ArabicAR
ChineseZH
DanishDA
Dutch FlemishNL
FinnishFI
FrenchFR
GermanDE
HungarianHU
IcelandicIS
ItalianIT
JapaneseJP
JapaneseJA
KoreanKO
LatvianLV
LithuanianLT
NorwegianNO
PolishPL
PortuguesePT
RussianRU
SpanishES
SwedishSV

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
-