QueryDomainByDomainName - API Reference (New)| Alibaba Cloud Documentation Center

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters


Parameter	Type	Required	Example	Description
Action	String	Yes	QueryDomainByDomainName	The operation that you want to perform. Set the value to QueryDomainByDomainName.
DomainName	String	Yes	test.com	The domain name that you want to query.
Lang	String	No	en	The language of the error message to return. Valid values: zh: Chinese en: English Default value: en
UserClientIp	String	No	127.0.0.1	The IP address of the client used by the user to initiate the query.

Response parameters


Parameter	Type	Example	Description
DnsList	List	dns1.hichina.com,dns2.hichina.com	The DNS server list returned.
Dns			The name of the DNS server returned.
DomainName	String	test.com	The domain name that was queried.
DomainNameProxyService	Boolean	false	Indicates whether privacy protection is enabled for the domain name.
DomainNameVerificationStatus	String	SUCCEED	The audit status of the domain name. Valid values: NONAUDIT: Not verified SUCCEED: Succeeded FAILED: Failed AUDITING: Being reviewed
Email	String	test@alibaba-inc.com	The email address of the registrant.
EmailVerificationClientHold	Boolean	false	Indicates whether the domain name is in the ClientHold state.
EmailVerificationStatus	Integer	1	Indicates whether the email address has passed the verification. Valid values: 0: Failed 1: Successful
ExpirationDate	String	2019-12-07 17:02:13	The time when the domain name expired.
ExpirationDateLong	Long	1625111915000	The timestamp when the domain name expired.
InstanceId	String	S20179H1BBI9test	The instance ID of the domain that was queried.
Premium	Boolean	false	Indicates whether the domain name is a premium word.
RealNameStatus	String	NONAUDIT	The status of the real-name verification for the domain name. Valid values: NONAUDIT: Not verified SUCCEED: Succeeded FAILED: Failed AUDITING: Being reviewed
RegistrantName	String	Test litm	The contact for the domain name.
RegistrantOrganization	String	Test litm	The registrant of the domain name.
RegistrantType	String	1	The type of the contact for the domain name registration. Valid values: 1: Individuals 2: Enterprises
RegistrantUpdatingStatus	String	NORMAL	The modification status of the information about the domain name registrant. Valid values: PENDING: Being modified NORMAL: Normal
RegistrationDate	String	2017-12-07 17:02:13	The time when the domain name was registered.
RegistrationDateLong	Long	1584675448000	The timestamp when the domain name was registered.
RequestId	String	44101664-3E70-4F0E-89E5-CCB74BF22147	The ID of the request.
TransferOutStatus	String	NORMAL	The transfer-out status of the domain name. Valid values: NORMAL: Normal PENDING: Being transferred out of Alibaba Cloud's HiChina
TransferProhibitionLock	String	CLOSE	The transfer lock status of the domain name. Valid values: NONE_SETTING: Not set OPEN: Enabled CLOSE: Disabled
UpdateProhibitionLock	String	CLOSE	The security lock status of the domain name. Valid values: NONE_SETTING: Not set OPEN: Enabled CLOSE: Disabled
UserId	String	121000000test	The ID of the Alibaba Cloud user.
ZhRegistrantName	String	LiSi	The Chinese name of the contact.
ZhRegistrantOrganization	String	LiSi	The Chinese name of the domain name registrant.

Examples

Sample requests


http(s)://[Endpoint]/? Action=QueryDomainByDomainName
&DomainName=test.com
&<Common request parameters>

Sample success responses

XML format

<QueryDomainByDomainNameResponse>
	  <ZhRegistrantOrganization>LiSi</ZhRegistrantOrganization>
	  <UpdateProhibitionLock>CLOSE</UpdateProhibitionLock>
	  <InstanceId>S2019270W5******</InstanceId>
	  <ExpirationDateLong>1584675448000</ExpirationDateLong>
	  <ZhRegistrantName>LiSi</ZhRegistrantName>
	  <DomainNameProxyService>false</DomainNameProxyService>
	  <ExpirationDate>2020-03-20 11:37:28</ExpirationDate>
	  <RegistrantType>1</RegistrantType>
	  <DomainName>test.com</DomainName>
	  <DnsList>
		    <Dns>dns1.hichina.com</Dns>
		    <Dns>dns2.hichina.com</Dns>
	  </DnsList>
	  <TransferProhibitionLock>CLOSE</TransferProhibitionLock>
	  <RegistrationDateLong>1553053048000</RegistrationDateLong>
	  <EmailVerificationStatus>1</EmailVerificationStatus>
	  <RealNameStatus>SUCCEED</RealNameStatus>
	  <UserId>1406926474******</UserId>
	  <Premium>false</Premium>
	  <Email>test@alibaba-inc.com</Email>
	  <RegistrationDate>2019-03-20 11:37:28</RegistrationDate>
	  <RequestId>F5BE26DC-9287-4F1C-B2EB-4124C4ACC349</RequestId>
	  <EmailVerificationClientHold>false</EmailVerificationClientHold>
	  <RegistrantUpdatingStatus>NORMAL</RegistrantUpdatingStatus>
	  <TransferOutStatus>NORMAL</TransferOutStatus>
	  <DomainNameVerificationStatus>SUCCEED</DomainNameVerificationStatus>
	  <RegistrantName>li si</RegistrantName>
	  <RegistrantOrganization>li si</RegistrantOrganization>
</QueryDomainByDomainNameResponse>

JSON format

{
	"ZhRegistrantOrganization":"LiSi",
	"UpdateProhibitionLock":"CLOSE",
	"InstanceId":"S2019270W5******",
	"ExpirationDateLong":1584675448000,
	"ZhRegistrantName":"LiSi",
	"ExpirationDate":"2020-03-20 11:37:28",
	"DomainNameProxyService":false,
	"RegistrantType":"1",
	"DomainName":"test.com",
	"DnsList":{
		"Dns":[
			"dns1.hichina.com",
			"dns2.hichina.com"
		]
	},
	"TransferProhibitionLock":"CLOSE",
	"RegistrationDateLong":1553053048000,
	"EmailVerificationStatus":1,
	"RealNameStatus":"SUCCEED",
	"UserId":"1406926474******",
	"Premium":false,
	"Email":"test@alibaba-inc.com",
	"RegistrationDate":"2019-03-20 11:37:28",
	"RequestId":"F5BE26DC-9287-4F1C-B2EB-4124C4ACC349",
	"EmailVerificationClientHold":false,
	"RegistrantUpdatingStatus":"NORMAL",
	"TransferOutStatus":"NORMAL",
	"DomainNameVerificationStatus":"SUCCEED",
	"RegistrantName":"li si",
	"RegistrantOrganization":"li si"
}

Error codes

For a list of error codes, visit the API Error Center.