Search in this section

Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
titleColor#FFFFFF
titleBGColor#E44313
titleTable of contents

Table of Contents
outlinetrue
stylenone

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
titleNote

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

Code Block
languagexml
titleDomain Check Request
linenumberstrue
<?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>
Code Block
languagexml
titleDomain Check Response
linenumberstrue
<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>