CheckDomain - Domain Names - Alibaba Cloud Documentation Center

Queries whether a domain name can be registered.

For more information about how to determine the validity of domain names, see Domain name validity.

Note

The frequency of calling the CheckDomain operation is limited. The limit is 10 queries per second (QPS) for a single user and 100 QPS for this operation in total.

Debugging

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

Request parameters

Parameter	Type	Required	Example	Description
Action	String	Yes	CheckDomain	The operation that you want to perform. Set the value to CheckDomain.
DomainName	String	Yes	test**.xin	The domain name that you want to query.
FeeCommand	String	No	create	The operation command. Valid values: create: Purchase a domain name. renew: Renew a domain name. transfer: Transfer a domain name to Alibaba Cloud. restore: Redeem a domain.
FeeCurrency	String	No	USD	The type of the currency. Valid values: USD: United States dollar
FeePeriod	Integer	No	1	The subscription duration of the domain name. Unit: Year. Valid values: 1 to 10.
Lang	String	No	en	The language of the error message returned. Valid values: zh: Chinese en: English Default value: en.

Response parameters

Parameter	Type	Example	Description
Avail	String	1	Indicates whether the domain name can be registered. Valid values: 1: The domain name can be registered. 3: The domain name can be preregistered. 4: The preregistration of the domain name can be deleted. 0: The domain name cannot be registered. -1: The domain name is abnormal. -2: The registration of the domain name is suspended. -3: The domain name is added to a blacklist.
DomainName	String	test**.xin	The domain name that is queried.
DynamicCheck	Boolean	true	Indicates whether the price of the domain name is determined by the domain name registry. Valid values: true: The price of the domain name is determined by the domain name registry. false: The price of the domain name is not determined by the domain name registry.
Premium	String	true	Indicates whether the domain name is a premium domain name. Valid values: true: The domain name is a premium domain name. false: The domain name is not a premium domain name.
Price	Long	1286	The registration price of a premium domain name.
Reason	String	In use	The reason returned by the domain name registry for the domain name that cannot be registered. Note The reasons vary based on domain name registries.
RequestId	String	BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1	The ID of the request.

Examples

Sample requests

http(s)://domain.aliyuncs.com/? Action=CheckDomain
&DomainName=test**.xin
&<Common request parameters>

Sample success responses

XML format

<CheckDomain>
      <RequestId>BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1</RequestId>
      <DomainName>test**.xin</DomainName>
      <Avail>1</Avail>
      <DynamicCheck>true</DynamicCheck>
      <Premium>false</Premium>
      <Reason></Reason>
      <Price>1286</Price>
      <StaticPriceInfo>
          <PriceInfo>
              <action>activate</action>
              <money>78</money>
              <period>12</period>
          </PriceInfo>
      </StaticPriceInfo>
</CheckDomain>

JSON format

{
    "RequestId": "BA7A4FD4-EB9A-4A20-BB0C-9AEB15634DC1",
    "DomainName": "test**.xin",
    "Avail": "1",
    "DynamicCheck": true,
    "Premium": false,
    "Reason": "",
    "Price": 1286,
    "StaticPriceInfo": {
        "PriceInfo": [
            {
              "action": "activate",
              "money": 78,
              "period": 12
            }
        ]
    }
}

Error codes

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