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 element:

• 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 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 in the current rolling 24 hour period.
2. Responses of "0" indicates a domain is registered, "1" indicates unregistered.