edit-icon download-icon

Initiate domain name retrieval

Last Updated: Dec 29, 2017


A verification email is sent to your whois email address based on the input parameters. Click the verification link in the whois inbox to jump to the Alibaba Cloud DNS management platform.

Request parameters

Name Type Required? Description
Action String Yes Operation interface name, required parameter. Value: RetrievalDomainName.
DomainName String Yes Domain name.

Return parameters

Public return parameters. For more information, see Public return parameters.

Name Type Description
RequestId String The unique request identifier.
DomainName String Domain name.
WhoisEmail String The whois email address to receive the verification code.

Error codes

For errors common to all interfaces, see Error code table.

Error code Description HTTP status code Meaning
InvalidDomainName.Format The format of domain is error. 400 Domain name format error.
InvalidDomainName.Suffix The domain suffix isnot been supported. 400 The domain name suffix is not supported.
InvalidDomainName.Unregistered The domain name is not registered. 400 The domain name is not registered.
InvalidDomainName.Duplicate The domain name is duplicated in this user’s domain list. 400 The domain name already exists in the user’s domain list.
CHNDomainInfoNotMatch The information of chinese domain does not match with CNNIC. 400 The Chinese domain name does not match the information returned by CNNIC (See Note).
UnabletoGetWoisInfo The domain is unable to get information from whois system. 400 Cannot retrieve Whois information.
InvalidDomainName.NoExist The domain is not exist in Alibaba Cloud DNS system. 400 The domain name does not exist in the Alibaba Cloud DNS system.
UnableToGetWhoisEmail The domain is unable to get whois email. 400 Whois email address not retrieved.
Forbidden.DomainType TThe domain is forbidden to operate because it is a hichina domain. 400 HiChina domain names cannot be retrieved.
Forbidden.TooOfen The operation is too ofen in 90 seconds. 400 Forbidden to re-attempt retrieval within 90 seconds.
Forbidden.ProtectedDomain The domain is forbidden to operation because this is a protected domain in white list. 400 Domain names in the whitelist cannot be retrieved.


Request example

  1. http://dns.aliyuncs.com/?Action=RetrievalDomainName
  2. &DomainName=example.com
  3. &<Public Request Parameters>

Return example

  • XML format
  1. <RetrievalDomainNameResponse>
  2. <RequestId>536E9CAD-DB30-4647-AC87-AA5CC38C5382</RequestId>
  3. <DomainName>example.com</DomainName>
  4. <WhoisEmail>webmaster@gmail.com</WhoisEmail>
  5. </RetrievalDomainNameResponse>
  • JSON format
  1. {
  2. "RequestId": "536E9CAD-DB30-4647-AC87-AA5CC38C5382",
  3. "DomainName": "example.com",
  4. "WhoisEmail": "webmaster@gmail.com"
  5. }
Thank you! We've received your feedback.