The <domain:check> command is used to determine if an object can be provisioned within a registry and provides a hint to determine if a <create> command would be successful. The <check> command only applies to domains and cannot be processed for other accounts, contacts or nameserver objects.

Domains

<domain:check> element

The <domain:check> element contains the following child elements:

• One or more <domain:name> elements giving the domain names to be queried.

Usage

The <domain:check> command is subject to the Acceptable Use Policy. A check for multiple domains in one request will only succeed if the registrar is sufficiently below their abuse limit to guarantee completing the whole request.

We are currently (from 6 April 2010) investigating the impact of increased check limits on our EPP server. If you would like to help with load testing of the system, please contact support@nominet.org.uk.

Examples

Example of a <domain:check> command

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
   xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
   xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0
   epp-1.0.xsd">
   <command>
    <check>
      <domain:check
        xmlns:domain="http://www.nominet.org.uk/epp/xml/nom-domain-2.0"
        xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-domain-2.0
        nom-domain-2.0.xsd">
        <domain:name>example.co.uk</domain:name>
        <domain:name>example2.co.uk</domain:name>
        <domain:name>example.com</domain:name>
      </domain:check>
    </check>
    <clTRID>ABC-12345</clTRID>
  </command>
</epp>

Example successful <domain:check> response

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
  <epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0
       epp-1.0.xsd">
    <response>
      <result code="1000">
        <msg>Command completed successfully</msg>
      </result>
      <resData>
        <domain:chkData abuse-limit="1000"
         xmlns:domain="http://www.nominet.org.uk/epp/xml/nom-domain-2.0"
         xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-domain-2.0
         nom-domain-2.0.xsd">
          <domain:cd>
            <domain:name avail="0">example.co.uk</domain:name>
          </domain:cd>
          <domain:cd>
            <domain:name avail="1">example2.co.uk</domain:name>
          </domain:cd>
          <domain:cd>
            <domain:name avail="0">example.com</domain:name>
          </domain:cd>
        </domain:chkData>
      </resData>
      <trID>
        <clTRID>ABC-12345</clTRID>
        <svTRID>265768</svTRID>
      </trID>
    </response>
  </epp>

 

Notes

 

1. The "abuse-limit" attribute gives the remaining number of checks/creates on existing domain names in the current rolling 24 hour period.
2. Responses of "0" indicates a domain is registered, "1" indicates unregistered.