.com

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.com
period          = (INT)
ownercontact0   = (CONTACT)
admincontact0   = (CONTACT)
techcontact0    = (CONTACT)
billingcontact0 = (CONTACT)
nameserver0  = (NAMESERVER)
nameserver1   = (NAMESERVER)

After successful registration, there is a 60 days transfer lock.

Domain Modification

(API Command reference » ModifyDomain)

Command

command = ModifyDomain
domain  = yourdomain.com

Domain Renewal

(API Command reference » RenewDomain)

Command

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

Domain Deletion

(API Command reference » DeleteDomain)

Command

COMMAND = DeleteDomain
DOMAIN = yourdomain.com

Domain Transfer

(API Command reference » TransferDomain)

Transfer Procedure

Exception

command = TransferDomain
domain = (DOMAIN)
action = REQUEST
auth = (TEXT)
ownercontact0 = (CONTACT)
admincontact# = (CONTACT)
techcontact# = (CONTACT)
billingcontact# = (CONTACT)

• 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 .com 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 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

command = RestoreDomain
domain  = yourdomain.com

Domain Restrictions

There are no restrictions for .com

Supported IDN Scripts

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

Afrikaans	AFR
Albanian	ALB
Arabic	ARA
Aragonese	ARG
Armenian	ARM
Assamese	ASM
Asturian	AST
Avestan	AVE
Awadhi	AWA
Azerbaijani	AZE
Balinese	BAN
Baluchi	BAL
Basa	BAS
Bashkir	BAK
Basque	BAQ
Belarusian	BEL
Bengali	BEN
Bhojpuri	BHO
Bosnian	BOS
Bulgarian	BUL
Burmese	BUR
Carib	CAR
Catalan	CAT
Chechen	CHE
Chinese	CHI
Chuvash	CHV
Coptic	COP
Corsican	COS
Croatian	SCR
Czech	CZE
Danish	DAN
Divehi	DIV
Dogri	DOI
Dutch	DUT
English	ENG
Estonian	EST
Faroese	FAO
Fijian	FIJ
Finnish	FIN
French	FRE
Frisian	FRI
Gaelic	GLA
Georgian	GEO
German	GER
Gondi	GON
Greek	GRE
Gujarati	GUJ
Hebrew	HEB
Hindi	HIN
Hungarian	HUN
Icelandic	ICE
Indic	INC
Indonesian	IND
Ingush	INH
Irish	GLE
Italian	ITA
Japanese	JPN
Javanese	JAV
Kashmiri	KAS
Kazakh	KAZ
Khmer	KHM
Kirghiz	KIR
Korean	KOR
Kurdish	KUR
Lao	LAO
Latvian	LAV
Lithuanian	LIT
Luxembourgisch	LTZ
Macedonian	MAC
Malay	MAY
Malayalam	MAL
Maltese	MLT
Maori	MAO
Moldavian	MOL
Mongolian	MON
Nepali	NEP
Norwegian	NOR
Oriya	ORI
Ossetian	OSS
Panjabi	PAN
Persian	PER
Polish	POL
Portuguese	POR
Pushto	PUS
Rajasthani	RAJ
Romanian	RUM
Russian	RUS
Samoan	SMO
Sanskrit	SAN
Sardinian	SRD
Serbian	SCC
Sindhi	SND
Sinhalese	SIN
Slovak	SLO
Slovenian	SLV
Somali	SOM
Spanish	SPA
Swahili	SWA
Swedish	SWE
Syriac	SYR
Tajik	TGK
Tamil	TAM
Telugu	TEL
Thai	THA
Tibetan	TIB
Turkish	TUR
Ukrainian	UKR
Urdu	URD
Uzbek	UZB
Vietnamese	VIE
Welsh	WEL
Yiddish	YID

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.