Table of contents

Description

The DomainCheck command checks at the registry whether a domain can be registered or not.

When is a domain "available" ?

If a domain is available can be determined by looking at the "avail" attribute. The values "0" and "1" can be returned. The value "0" is returned when one of the following conditions is met.

ReasonExplanation
Domain is in use.The domain is in use and cannot be registered.
  • Domain is not restorable.
  • Domain is in use.
The domain is in your possession, expired and a domain restore may be possible.
Reserved domain.The domain is listed in the respective black list of the registry.
Premium domain.The domain is listed in the respective premium list of the registry.
Invalid domain name, expected a domain name.The domain could not be processed by the system.
Domainname is invalid.The domain contains invalid characters ( IDN ).
Invalid tld.The TLD of the Domain is invalid.

Note

The domain check command does not inquire the inventory of the registry. This is why the domain check command does not return reliable information if a domain is available for registration. Please use our WhoisProxy for this specific purpose.

XML example

Request
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
    <command>
        <check>
            <domain:check xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
                <domain:name>free.com</domain:name>
				<domain:name>in-use.com</domain:name>
			</domain:check>
 		</check>
        <clTRID>ABC-12345</clTRID>
    </command>
</epp>
Response
<epp xmlns:domain="urn:ietf:params:xml:ns:domain-1.0">
    <response>
        <result code="1000">
            <msg lang="en">Command completed successfully</msg>
        </result>
        <resData>
            <domain:chkData>
                <domain:cd>
                    <domain:name avail="0">free.com</domain:name>
                </domain:cd>
 				<domain:cd>
                    <domain:name avail="1">in-use.de</domain:name>
                    <domain:reason lang="en">Domain is in use.</domain:reason>
                </domain:cd>
			</domain:chkData>
        </resData>
        <trID>
            <clTRID>ABC-12345</clTRID>
        </trID>
    </response>
</epp>