Your browser don't permit web-fonts to be installed. Our websites use web-fonts based icons. For a better experience please allow your browser to use web-fonts.
We are hiring!
Deutsch | English | Español

2.9. Domain

The domain object provides methods for creating, deleting, listing etc. of domains.

2.9.1. domain.check

Check the availability of domains.

2.9.1.1. Input

Table 2.96. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name array_domain false 
sldSecond level domain name text64 false 
tldTop level domain array_text64 false 
regionCheck top level domains of the given groups array_identifier false 
wideMore detailed output int false1

2.9.1.2. Output

Table 2.97. Parameters

ParameterDescriptionTypeOptional
domain   
... domainDomain name token255  
... availDomain availability for registration int  
... statusDomain availability status text10 Yes
... checktimeDomain check time float Yes
... nameSecond level domain name text64 Yes
... tldTop level domain name text10 Yes
... checkmethodDomain check method text10 Yes
... priceDomain registration/transfer price float Yes

2.9.2. domain.create

Register a domain name.

2.9.2.1. Input

Table 2.98. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 true 
periodDomain registration/renewal period period false*
registrantDomain owner contact handle id int true 
adminDomain administrative contact handle id int true 
techDomain technical contact handle id int true 
billingDomain billing contact handle id int true 
nsList of nameserver nsList false 
transferLockLock domain boolean false1
renewalModeDomain renewal mode renewalMode false 
whoisProviderWhois provider token0255 false 
whoisUrlWhois url token0255 false 
scDateTime of scheduled execution timestamp false 
extDataDomain extra data extData false 
asynchronAsynchron domain create boolean falsefalse
voucherVoucher code text64 false 
testingExecute command in testing mode boolean falsefalse

2.9.2.2. Output

Table 2.99. Parameters

ParameterDescriptionTypeOptional
roIdId (Repository Object Identifier) of the domain int  
priceIncurred expenses float  
currencyCurrency related to price value customercurrency  

2.9.3. domain.delete

Deletes a domain.

2.9.3.1. Input

Table 2.100. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 true 
scDateTime of scheduled execution timestamp false 
testingExecute command in testing mode boolean falsefalse

2.9.3.2. Output

No additional return parameters

2.9.4. domain.getalldomainprices

Get all domain prices (e.g. reg, renewal) for a specified domain.

2.9.4.1. Input

Table 2.101. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name array_domain true 
periodperiod for the requested action text64 false 
voucherVoucher code text64 false 

2.9.4.2. Output

Table 2.102. Parameters

ParameterDescriptionTypeOptional
domain   
... premiumFlag, if the given price is premium boolean  
... currencyThe currency belonging to the prices customercurrency  
... periodThe value of the period, that is required for this item, will usually match period from request text64  
... promoFlag, if the given price is promo boolean  
... promoPriceThe Promo price of this item float  
... promoTypeThe type of the perfomed action for this promo action text64  
... regPriceThe registration price of this item float  
... updatePriceThe update price of this item float  
... transferPriceThe transfer price of this item float  
... tradePriceThe trading price of this item float  
... renewalPriceThe renewal price of this item float  
... restorePriceThe restore price of this item float  

2.9.5. domain.getdomainprice

Get the domain price by type (e.g. reg, renewal) for a specified domain.

2.9.5.1. Input

Table 2.103. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name array_domain true 
pricetypeType to get the price for. (Options: reg | renewal | transfer | update | trade | restore ) text64 true 
periodperiod for the requested action text64 false 
voucherVoucher code text64 false 

2.9.5.2. Output

Table 2.104. Parameters

ParameterDescriptionTypeOptional
domain   
... typeThe type of the perfomed action for this item, most likely the same value as pricetype text64  
... periodThe value of the period, that is required for this item, will usually match period from request text64  
... priceThe price of this item and action float  
... currencyThe currency belonging to the price customercurrency  
... promoFlag, if the given price is promo boolean  
... premiumFlag, if the given price is premium boolean  

2.9.6. domain.getextradatarules

Get extra rules for one or all TLDs.

2.9.6.1. Input

Table 2.105. Parameters

ParameterDescriptionTypeRequiredDefault
tldTop level domain text64 false 

2.9.6.2. Output

Table 2.106. Parameters

ParameterDescriptionTypeOptional
rulesList with rules and constraints of the top level domains array_text255  

2.9.7. domain.getPrices

Get the domain prices.

2.9.7.1. Input

Table 2.107. Parameters

ParameterDescriptionTypeRequiredDefault
tldTop level domain array_text64 false 
vatPrices with vat boolean falsetrue
vatCC2-letter ISO country code country false 
voucherVoucher code text64 false 
pagePage number for paging int false1
pagelimitMax number of results per page. Default is unlimited int false 

2.9.7.2. Output

Table 2.108. Parameters

ParameterDescriptionTypeOptional
price   
... tldTop level domain name text64  
... currencyCurrency of the price text10  
... createPriceDomain registration price/year float  
... monthlyCreatePriceDomain registration price/month float Yes
... transferPriceDomain transfer price/year float  
... renewalPriceDomain renewal price/year float  
... monthlyRenewalPriceDomain renewal price/month float Yes
... updatePriceDomain update price float  
... tradePriceDomain trade price float  
... trusteePriceDomain trustee service price/year float  
... monthlyTrusteePriceDomain trustee service price/month float Yes
... createPeriodDomain creation period in years int  
... transferPeriodDomain transfer period in years int  
... renewalPeriodDomain renewal period in years int  
... tradePeriodDomain trade period in years int  
... vatAdded value tax rate according to vat and vatCC settings float Yes
... promo  Yes
... ... currencyCurrency of the promo price text10  
... ... limitedNumberNumber of limited promos int  
... ... limitedRemainingNumber of remaining promo prices for limited promos int  
... ... startTimePromo start time dateTime  
... ... endTimePromo end time dateTime  
... ... periodThe period the promo offer applies to text10  
... ... tradePricetrade promo price float Yes
... ... trusteePricetrustee promo price float Yes
... ... createPriceDomain registration price/year float Yes
... ... monthlyCreatePriceDomain registration price/month float Yes
... ... transferPriceDomain transfer price/year float Yes
... ... renewalPriceDomain renewal price/year float Yes
... ... monthlyRenewalPriceDomain renewal price/month float Yes
... ... chargedPrice  Yes
... ... ... currencyCurrency of the promo price text10  
... ... ... createPriceDomain registration price/year float  
... ... ... monthlyCreatePriceDomain registration price/month float Yes
... ... ... transferPriceDomain transfer price/year float  
... ... ... renewalPriceDomain renewal price/year float  
... ... ... monthlyRenewalPriceDomain renewal price/month float Yes
... ... ... updatePriceDomain update price float  
... ... ... tradePriceDomain trade price float  
... ... ... trusteePriceDomain trustee service price/year float  
... ... ... monthlyTrusteePriceDomain trustee service price/month float Yes
... chargedPrice  Yes
... ... currencyCurrency of the promo price text10  
... ... createPriceDomain registration price/year float  
... ... monthlyCreatePriceDomain registration price/month float Yes
... ... transferPriceDomain transfer price/year float  
... ... renewalPriceDomain renewal price/year float  
... ... monthlyRenewalPriceDomain renewal price/month float Yes
... ... updatePriceDomain update price float  
... ... tradePriceDomain trade price float  
... ... trusteePriceDomain trustee service price/year float  
... ... monthlyTrusteePriceDomain trustee service price/month float Yes
... eur  Yes
... ... createPriceDomain registration price/year float  
... ... monthlyCreatePriceDomain registration price/month float Yes
... ... transferPriceDomain transfer price/year float  
... ... renewalPriceDomain renewal price/year float  
... ... monthlyRenewalPriceDomain renewal price/month float Yes
... ... updatePriceDomain update price float  
... ... tradePriceDomain trade price float  
... ... trusteePriceDomain trustee service price/year float  
... ... monthlyTrusteePriceDomain trustee service price/month float Yes

2.9.8. domain.getPromos

Get promo prices of TLDs.

2.9.8.1. Input

Table 2.109. Parameters

ParameterDescriptionTypeRequiredDefault
tldsList of specific TLDs to check for promos array_text64 false 
promoTypeDomain action (e.g. REG, RENEWAL) text64 falseREG
periodDomain period int false1
periodUnitDomain period unit (e.g. Y for years or M for months) text10 falseY
executionDateDate of promo request text64 false 
voucherVoucher code text64 false 

2.9.8.2. Output

Table 2.110. Parameters

ParameterDescriptionTypeOptional
promos   
... tldTLD name text64  
... ... netPriceNet promotional price float  
... ... currencyCurrency of net price customercurrency  
... ... endTimeEnd time of the promo dateTime  

2.9.9. domain.getRules

Get TLD rules.

2.9.9.1. Input

Table 2.111. Parameters

ParameterDescriptionTypeRequiredDefault
tldTop level domain name array_text64 false 

2.9.9.2. Output

Table 2.112. Parameters

ParameterDescriptionTypeOptional
rules   
... tldTop level domain name text64  
... ccTLD country country  
... regionAll TLD groups this domain is part of array_identifier  
... timeRegistrationTime for registration text64  
... localOwnerLocal domain owner contact needed boolean  
... localAdminLocal domain administrative contact needed boolean  
... localTechLocal domain technical contact needed boolean  
... ownerTypeAllowed domain owner contact types text64  
... adminTypeAllowed domain administrative contact types text64  
... techTypeAllowed domain technical contact types text64  
... billingTypeAllowed domain billing contact types text64  
... billingFaxNeededDomain billing contact needs a fax number boolean  
... companyAllowedDomain owner contact can be a company boolean  
... personAllowedDomain owner contact can be a natural person boolean  
... companyNeededDomain owner contact has to be a company boolean  
... personNeededDomain owner contact has to be a natural person boolean  
... VATNeededVat number is needed boolean  
... IDNeededIdentification is needed boolean  
... markNeededTrademark is needed boolean  
... idnDomain name can contain idn chars boolean  
... idnCharsAllowed domain name idn characters token255  
... minLengthMinimal domain name length int  
... maxLengthMaximal domain name length int  
... minNSMinimum amount of nameservers int  
... maxNSMaximum amount of nameservers int  
... dnssecWhich type of DNSSEC record type is supported text64  
... registrationPeriodAllowed domain registration periods text64  
... renewalPeriodAllowed domain renewal periods text64  
... restorePeriod1Number of days after a EXPIRE INITIATED event in which a restore is possible int  
... restorePeriod2Number of days after a DELETE INITIATED event in which a restore is possible int  
... trusteeTrustee service available boolean  
... whoisProtectionWhois protection service available boolean  
... authCodeAuth code required/needed/optional text10  
... transferLockTLD registry supports transfer lock boolean  
... renewAllowedManual domain renewal is allowed text10  
... tradeAllowedDomain trade is allowed text10  
... pushAllowedDomain push is allowed text10  
... updateAllowedDomain update is allowed text10  
... updateAuthcodeAllowedUpdate domain auth code is allowed text10  
... transferAllowedDomain transfer is allowed text10  
... transferOutAllowedDomain transfer out ack is allowed text10  
... restoreAllowedDomain restore is allowed text10  
... paperworkDomain action requires additional paperwork int  
... restorePossibilityDomain restore possibility int  
... blacklistNot allowed second level domain names text  
... defaultRegistrationPeriodDefault Registration Period text  
... defaultRenewalPeriodDefault Renewal Period text  
... accreditationAccreditation text  
... tldAceUnicode TLD text  

2.9.10. domain.getTldGroups

Get groups for TLD

2.9.10.1. Input

Table 2.113. Parameters

ParameterDescriptionTypeRequiredDefault
tldTop level domain array_text64 false 

2.9.10.2. Output

Table 2.114. Parameters

ParameterDescriptionTypeOptional
groupsAll TLD groups this domain is part of array_identifier  

2.9.11. domain.info

Get domain details.

2.9.11.1. Input

Table 2.115. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 false 
roIdDomain id (Repository Object Identifier) int false 
wideMore detailed output int false1

2.9.11.2. Output

Table 2.116. Parameters

ParameterDescriptionTypeOptional
roIdId (Repository Object Identifier) of the domain int  
domainDomain name text64  
domain-aceDomain ace name text64  
periodDomain registration/renewal period period Yes
crDateTime of domain creation dateTime Yes
exDateTime of domain expiration dateTime Yes
upDateTime of last domain update dateTime Yes
reDateTime of domain renewal dateTime Yes
scDateTime of scheduled execution dateTime Yes
transferLockDomain is locked boolean Yes
statusStatus of the domain text64 Yes
authCodeDomain auth code token255 Yes
renewalModeDomain renewal mode renewalMode Yes
transferModeDomain transfer mode transferMode Yes
registrantDomain owner contact handle id int Yes
adminDomain administrative contact handle id int Yes
techDomain technical contact handle id int Yes
billingDomain billing contact handle id int Yes
nsList of nameserver nsList Yes
noDelegationDomain delegation status boolean Yes
contact  Yes
... registrantRegistrant contact handle details contact  
... adminAdministrative contact handle details contact  
... techTechnical contact handle details contact  
... billingBilling contact handle details contact  
extDataDomain extra data extData Yes
verificationStatusContact Verification Status text64 Yes
registrantVerificationStatusContact Verification Status text64 Yes

2.9.12. domain.list

List all available customers domains.

2.9.12.1. Input

Table 2.117. Parameters

ParameterDescriptionTypeRequiredDefault
domainFilter by domain name search string array_text255 false*
roIdFilter by domain id (Repository Object Identifier) array_int false 
statusFilter by domain status array_text64 false 
registrantFilter by registrant ids array_int false 
adminFilter by admin ids array_int false 
techFilter by tech ids array_int false 
billingFilter by billing ids array_int false 
renewalModeFilter by renewal mode renewalMode false 
transferLockFilter by transfer lock boolean false 
noDelegationFilter by delegation status boolean false 
tagFilter by tag ids array_int false 
wideMore detailed output int false1
orderSort order of result list domainOrder falseDOMAINASC
pagePage number for paging int false1
pagelimitMax number of results per page int false20
withPrivacyFilter by Privacy option (1 is true) int false 

2.9.12.2. Output

Table 2.118. Parameters

ParameterDescriptionTypeOptional
countTotal number of preregistrations int  
domain   
... roIdId (Repository Object Identifier) of the domain int  
... domainDomain name token255  
... domain-aceDomain ace name token255  
... periodDomain registration/renewal period period Yes
... crDateTime of domain creation dateTime Yes
... exDateTime of domain expiration dateTime Yes
... upDateTime of last domain update dateTime Yes
... reDateTime of domain renewal dateTime Yes
... scDateTime of scheduled execution dateTime Yes
... transferLockDomain is locked boolean Yes
... statusStatus of the domain text64 Yes
... authCodeDomain auth code token255 Yes
... renewalModeDomain renewal mode renewalMode Yes
... transferModeDomain transfer mode transferMode Yes
... registrantDomain owner contact handle id int Yes
... adminDomain administrative contact handle id int Yes
... techDomain technical contact handle id int Yes
... billingDomain billing contact handle id int Yes
... nsList of nameserver nsList Yes
... noDelegationDomain delegation status boolean Yes
... contact  Yes
... ... registrantRegistrant contact handle details contact  
... ... adminAdministrative contact handle details contact  
... ... techTechnical contact handle details contact  
... ... billingBilling contact handle details contact  
... extDataDomain extra data extData Yes
... verificationStatusContact Verification Status text64 Yes

2.9.13. domain.log

Log of changes to a domain.

2.9.13.1. Input

Table 2.119. Parameters

ParameterDescriptionTypeRequiredDefault
domainFilter result by domain name token255 false 
statusFilter result by status text64 false 
invoiceFilter result by invoice id text64 false 
dateFromLog start date timestamp false 
dateToLog end date timestamp false 
priceMinMinimum price of log entry float false0.0
priceMaxMaximum price of log entry float false 
orderordering of the results domainLogOrder falseLOGTIMEDESC
pagePage number for paging int false1
pagelimitMax number of results per page int false20

2.9.13.2. Output

Table 2.120. Parameters

ParameterDescriptionTypeOptional
countTotal number of log entries int  
sumSum of amount float  
domain   
... dateLog timestamp dateTime  
... roIdId (Repository Object Identifier) of the domain int  
... domainDomain name token255  
... statusDomain status text64  
... priceIncurred expenses of the domain action float  
... invoiceInvoice id text64  
... remoteAddrIp address of executing client ip  
... userTextDomain action description text255  
... logIdID of the log entry int  

2.9.14. domain.priceChanges

Get changes of domain prices.

2.9.14.1. Input

No parameters allowed

2.9.14.2. Output

Table 2.121. Parameters

ParameterDescriptionTypeOptional
futureChanges   
... tldTop level domain name text64  
... affectsCustomerCustomer has active domains for the TLD boolean  
... currencyCurrency of the price text10  
... changeDateDate of the price's change dateTime  
... createPriceDomain registration price/year float  
... monthlyCreatePriceDomain registration price/month float Yes
... transferPriceDomain transfer price/year float  
... renewalPriceDomain renewal price/year float  
... monthlyRenewalPriceDomain renewal price/month float Yes
... updatePriceDomain update price float  
... tradePriceDomain trade price float Yes
... trusteePriceDomain trustee service price/year float Yes
... monthlyTrusteePriceDomain trustee service price/month float Yes
... restorePriceDomain restore price float Yes
pastChanges   
... tldTop level domain name text64  
... currencyCurrency of the price text10  
... changeDateDate of the price's change dateTime  
... createPriceDomain registration price/year float  
... monthlyCreatePriceDomain registration price/month float Yes
... transferPriceDomain transfer price/year float  
... renewalPriceDomain renewal price/year float  
... monthlyRenewalPriceDomain renewal price/month float Yes
... updatePriceDomain update price float  
... tradePriceDomain trade price float Yes
... trusteePriceDomain trustee service price/year float Yes
... monthlyTrusteePriceDomain trustee service price/month float Yes
... restorePriceDomain restore price float Yes

2.9.15. domain.push

Return domain to registry (if supported by TLD).

2.9.15.1. Input

Table 2.122. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 true 
targetTarget registrar (if supported) text64 false 
scDateScheduled execution date timestamp false 
testingExecute command in testing mode boolean falsefalse

2.9.15.2. Output

No additional return parameters

2.9.16. domain.renew

Manual domain renewal.

2.9.16.1. Input

Table 2.123. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 true 
periodDomain renewal period period true 
expirationDate of current expiration date true 
asynchronAsynchron domain renew boolean falsefalse
testingExecute command in testing mode boolean falsefalse

2.9.16.2. Output

Table 2.124. Parameters

ParameterDescriptionTypeOptional
roIdId (Repository Object Identifier) of the domain int  
priceIncurred expenses float  
currencyCurrency related to price value customercurrency  
exDateTime of domain expiration dateTime  
reDateTime of next domain renewal dateTime  

2.9.17. domain.restore

Restores an expired/deleted domain (if supported).

2.9.17.1. Input

Table 2.125. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 true 
renewalModeDomain renewal mode renewalMode false 
testingExecute command in testing mode boolean falsefalse

2.9.17.2. Output

Table 2.126. Parameters

ParameterDescriptionTypeOptional
domainDomain name text64  
domainAceDomain ace name text64  

2.9.18. domain.stats

Get registered domain TLD statistics.

2.9.18.1. Input

No parameters allowed

2.9.18.2. Output

Table 2.127. Parameters

ParameterDescriptionTypeOptional
tld  Yes
... countTotal number of registered TLD int  

2.9.19. domain.trade

Change domain owner (if supported).

2.9.19.1. Input

Table 2.128. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 true 
registrantNew domain owner contact handle id int true 
adminNew administrative contact handle id int true 
techNew technical contact handle id int true 
billingNew billing contact handle id int true 
nsList of nameserver nsList false 
authCodeAuthorization code (if supported) token255 false 
whoisProviderWhois provider token0255 false 
whoisUrlWhois url token0255 false 
scDateScheduled execution date timestamp false 
extDataDomain trade extra data extData false 
asynchronAsynchron domain trade boolean falsefalse
testingExecute command in testing mode boolean falsefalse

2.9.19.2. Output

Table 2.129. Parameters

ParameterDescriptionTypeOptional
roIdId (Repository Object Identifier) of the domain int  
priceIncurred expenses float  
currencyCurrency related to price value customercurrency  

2.9.20. domain.transfer

Transfer domain from another registrar or user to you.

2.9.20.1. Input

Table 2.130. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 true 
registrantDomain owner contact handle id int false 
adminDomain administrative contact handle id int false 
techDomain technical contact handle id int false 
billingDomain billing contact handle id int false 
nsList of nameserver nsList false 
nsTakeoverKeep existing nameservers boolean falsefalse
contactTakeoverTransfer also data related to the transfered gTLD boolean falsefalse
transferLockLock domain boolean false1
authCodeAuthorization code (if supported) token255 false 
renewalModeDomain renewal mode renewalMode false 
whoisProviderWhois provider token0255 false 
whoisUrlWhois url token0255 false 
extDataDomain extra data extData false 
scDateTime of scheduled execution timestamp false 
asynchronAsynchron domain transfer boolean falsefalse
voucherVoucher code text64 false 
testingExecute command in testing mode boolean falsefalse

2.9.20.2. Output

Table 2.131. Parameters

ParameterDescriptionTypeOptional
roIdId (Repository Object Identifier) of the domain int  
priceIncurred expenses float  
currencyCurrency related to price value customercurrency  

2.9.21. domain.transfercancel

Cancel the transfer of a domain to another registrar or user.

2.9.21.1. Input

Table 2.132. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 true 

2.9.21.2. Output

No additional return parameters

2.9.22. domain.transferOut

Allow or deny outgoing transfer requests.

2.9.22.1. Input

Table 2.133. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 true 
answerAcknowledge or deny the domain request transferAnswer true 
testingExecute command in testing mode boolean falsefalse

2.9.22.2. Output

No additional return parameters

2.9.23. domain.update

Update domain data.

2.9.23.1. Input

Table 2.134. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 true 
registrantNew owner contact handle id int false 
adminNew administrative contact handle id int false 
techNew technical contact handle id int false 
billingNew billing contact handle id int false 
nsList of nameserver nsList false 
transferLockLock domain boolean false 
periodDomain registration/renewal period period false 
authCodeAuthorization code (if supported) token255 false 
scDateTime of scheduled execution timestamp false 
renewalModeDomain renewal mode renewalMode false 
transferModeDomain transfer mode transferMode false 
whoisProviderWhois provider token0255 false 
whoisUrlWhois url token0255 false 
extDataDomain extra data extData false 
asynchronAsynchron domain update boolean falsefalse
testingExecute command in testing mode boolean falsefalse

2.9.23.2. Output

Table 2.135. Parameters

ParameterDescriptionTypeOptional
priceIncurred expenses float  
currencyCurrency related to price value customercurrency  

2.9.24. domain.whois

Get the whois information of a domain.

2.9.24.1. Input

Table 2.136. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 true 

2.9.24.2. Output

Table 2.137. Parameters

ParameterDescriptionTypeOptional
whoisWhois output text