Domain:check
Check for availability
To find out whether a domain is still available or not, you can send the following request to our server. If you specify multiple domains, do not forget to increase the timeout value of your scripts as it may take a couple of seconds before our server will return an answer.
Please note that this service is not available for all top-level domains and that the number of daily requests is limited. This limitation is necessary due to the fact that most of the registries limit the number of allowed requests and blacklist IP addresses exceeding this limit.
You can find the number of allowed request in the section Your profile > Allowed requests.
XML Template
<?xml version="1.0" encoding="UTF-8"?>
<request xmlns:domain="http://www.eurodns.com/domain">
<domain:check>
<domain:name>#DOMAIN.TLD#</domain:name>
</domain:check>
</request>
<domain:check> (Occurrences: 1)
<domain:name> (Occurrences: 1+)
Note: Repeat this section to check multiple domains in one request
R | #DOMAIN.TLD# | Name of the domain to check for availability |
If the action was successful, the following code will be returned:
<?xml version="1.0" encoding="UTF-8"?>
<response xmlns:domain="http://www.eurodns.com/domain">
<result code="1000">
<msg>Command completed successfully</msg>
</result>
<resData>
<domain:check>
<domain:cd>
<domain:name avail="#AVAILABILITY#">#DOMAIN.TLD#</domain:name>
<domain:reason code="#CODE#" lang="#LANGUAGE#">#STATUS DESCRIPTION#</domain:reason>
</domain:cd>
</domain:check>
</resData>
</response>
<resData> (Occurrences: 1)
<domain:check> (Occurrences: 1)
<domain:cd> (Occurrences: 1+)
Note: If multiple domains have been specified, this section will be repeated
R | #DOMAIN.TLD# | Name of the checked domain |
R | #AVAILABILITY# | Whether the domain is available or not (true/false) |
R | #CODE# | Code of the description |
R | #LANGUAGE# | Language of the description |
R | #STATUS DESCRIPTION# | Description of the returned status |
List of the possible values
#AVAILABILITY# | #CODE# | #LANGUAGE# | #STATUS DESCRIPTION# |
---|---|---|---|
true | 100 | en | This domain is available |
false | 200 | en | This domain is taken |
false | 210 | en | Invalid top-level domain specified |
false | 211 | en | Domains under this top-level domain cannot be checked for availability |
false | 220 | en | This domain name has a wrong syntax |
false | 230 | en | This domain has been blacklisted |
false | 231 | en | This domain name is not allowed by the registry |
false | 240 | en | We do not offer the registration of internationalised domain names (IDN) |
false | 250 | en | Another client has ordered this domain for the landrush |
false | 251 | en | We have already received documents for the Sunrise 1 period of this domain |
false | 252 | en | There is a pending application for the domain |
false | 260 | en | Timeout while connecting to the WHOIS server, please try again later |
false | 300 | en | An error occurred whil querying this domain |
false | 301 | en | Unknown error |
Legend
O | The element is optional and does not have to be specified in the request and/or answer |
R | The element is mandatory and has to specified in the request and/or answer |