.org

API commandsRestrictionsIDN

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.org
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.org

Domain Renewal

(API Command reference » RenewDomain)

Command

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

Domain Deletion

(API Command reference » DeleteDomain)

Command

COMMAND = DeleteDomain
DOMAIN = yourdomain.org

Domain Transfer

(API Command reference » TransferDomain)

Command

command = TransferDomain
domain = yourdomain.org
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 .org 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 character:a-z; A-Z
Numeric character : 0-9
Special characters: !;<=$%?&@[()]*^+-,’-{.|/}:~

Domain Restore

(API Command reference » RestoreDomain)

Command

command = RestoreDomain
domain  = yourdomain.org

Restores are possible within 30 days upon deletion. A restore can be done via API command or via webinterface.

Domain Restrictions

You have to specify at least 2 nameservers for a .org domain to become active. You may not specify more than 13 nameservers for .org domains.

IDN Information

The following language tags must be utilized for Cyrillic IDNs:

• Bosnian (BS)
• Bulgarian (BG)
• Belarusian (BE)
• Macedonian (MK)
• Russian (RU)
• Serbian (SR)
• Ukrainian (UK)

Supported IDN Scripts

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

Belarusian	BE
Bosnian	BS
Bulgarian	BG
Danish	DA
German	DE
Hungarian	HU
Icelandic	IS
Korean	KO
Latvian	LV
Lithuanian	LT
Macedonian	MK
Polish	PL
Russian	RU
Serbian	SR
Simplified Chinese	ZH-CN
Spanish	ES
Swedish	SV
Traditional Chinese	ZH-TW
Ukranian	UK

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.