The poll command will be released on 9 Sep 2008.

When changes take place in the registration data for domain names or ENUMs on a tag, we send notifications to the registrar. It will be possible for registrars to elect to receive these notifications via EPP.

If a registrar elects to receive notifications via EPP, then notifications will be placed in the message queue awaiting a poll command to retrieve them. If the message queue is not empty, then a successful response to a poll command returns the first message from the queue.  This response includes a unique message identifier and a counter that gives the number of messages in the queue.

After a message has been received by the client, the client must respond to the client with an explicit acknowledgement to confirm that the message has been received. Then that message is dequeued and the next message in the queue becomes available for retrieval.

<epp:poll> element

The <epp:poll> element is an empty element. It has a single "op" attribute which may take the following values:

• "req" to retrieve the first message from the server message queue.
• "ack", to acknowledge receipt of a message. the message identifier is defined by a msgID attribute.

<epp:resData> element

The contents of the <epp:resData> depends upon the message type being returned and is described in the documentation for each notification.

Note: If 'epp' is chosen as the default namespace then the 'epp:' prefix can be omitted.

Examples

Polling for messages

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
  <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
    <command>
      <poll op="req"/>
      <clTRID>ABC-12345</clTRID>
    </command>
  </epp>

Example poll response

For illustrative purposes the <resData> element is empty in this example.

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   <response>
     <result code="1301">
       <msg>Command completed successfully; ack to dequeue</msg>
     </result>
     <msgQ count="5" id="12345">
       <qDate>2000-06-08T22:00:00.0</qDate>
       <msg>Domains Released Notification</msg>
     </msgQ>
     <resData>
     </resData>
     <trID>
       <clTRID>ABC-12345</clTRID>
       <svTRID>54321-XYZ</svTRID>
     </trID>
   </response>
 </epp>

Response to an acknowledgement

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
  <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
    <response>
      <result code="1000">
        <msg>Command completed successfully</msg>
      </result>
      <msgQ count="4" id="12345"/>
      <trID>
        <clTRID>ABC-12346</clTRID>
        <svTRID>54322-XYZ</svTRID>
      </trID>
    </response>
  </epp>