Check command
The <epp: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.
<enum:check> element
The <enum:check> element contains the following child elements:
- An <enum:E164Number> giving the first number in the range to be checked.
- An optional <enum:lastE164Number> giving the last number in the range to be checked.
Multiple <enum:check> operations can be performed in a single request by repeating the above sequence.
<enum:check> response
The <resData> element for an <enum:check> command contains a single <enum:chkData> element. This contains a list of <enum:cd> elements; one for each range requested. The <enum:cd> element will have an "avail" attribute determining if the range is available or not and the following sub-elements:
- An <enum:E164Number> giving the first number in the range.
- An <enum:lastE164Number> giving the last number in the range.
The "avail" attribute will be "1" if the entire range is available and "0" if any numbers in the range are registered.
Example <enum:check> request
The following <enum:check> commands checks the availability for the ranges +441865332100-+441865332500 and +441865333100-+441865333500 and the single number +441865331105.
<?xml version="1.0" encoding="UTF-8"?>
<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>
<enum:check
xmlns:enum="http://www.nominet.org.uk/epp/xml/nom-enum-2.0"
xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-enum-2.0
nom-enum-2.0.xsd">
<enum:E164Number>+441865332100</enum:E164Number>
<enum:lastE164Number>+441865332500</enum:lastE164Number>
<enum:E164Number>+441865331105</enum:E164Number>
<enum:E164Number>+441865333100</enum:E164Number>
<enum:lastE164Number>+441865333500</enum:lastE164Number>
</enum:check>
</check>
<clTRID>ABC-125849</clTRID>
</command>
</epp>
Example successful <enum:check> response
<?xml version="1.0" encoding="UTF-8"?>
<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>
<enum:chkData
xmlns:enum="http://www.nominet.org.uk/epp/xml/nom-enum-2.0"
xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/nom-enum-2.0
nom-enum-2.0.xsd">
<enum:cd avail="0">
<enum:E164Number>+441865332100</enum:E164Number>
<enum:lastE164Number>+441865332500</enum:lastE164Number>
</enum:cd>
<enum:cd avail="1">
<enum:E164Number>+441865331105</enum:E164Number>
<enum:lastE164Number>+441865331105</enum:lastE164Number>
</enum:cd>
<enum:cd avail="1">
<enum:E164Number>+441865333100</enum:E164Number>
<enum:lastE164Number>+441865333500</enum:lastE164Number>
</enum:cd>
</enum:chkData>
</resData>
<trID>
<clTRID>ABC-12345</clTRID>
<svTRID>10654896</svTRID>
</trID>
</response>
</epp>