Search in this section

Skip to end of metadata
Go to start of metadata
Table of contents

Description

The domain check command allows you to verify if a domain is in your possession.

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.

ReasonExplaination
Domain is in use.The domain is in your possession
  • 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

Domain Check Request
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<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>
Domain Check 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>