How can I POLL for changes via the API?

The actual code for the polling commands can be found in the API documentation available in the Downloads section of our website.

Polling will allow you to receive and acknowledge messages regarding the following events:

• Notifications on changes;
• Notifications on claims;
• Notifications on SMD creation;
• Additional: watermark messages.

Notifications contain the following elements:

• A counter that shows how many poll messages are in your queue;
• The ID of the current message (the message that is displayed);
• The POLL messages, each preceded by the message type unique identifier:
  • 102 Proof of use (POU) is expired
  • 103 Proof of use (POU) has been verified and approved
  • 104 Proof of use (POU) has not been approved and invalidated
  • 105 Proof of use (POU) is not approved. Further attention needed
  • 107 Mark certificate expired
  • 123 Mark record has been verified and approved
  • 124 Mark record is not approved. Further attention needed
  • 126 Mark record has not been approved and invalidated
  • 127 Mark record has not been corrected within 20 days and invalidated.
  • 134 Exception: validator still needs more info to approve mark
  • 137 Mark record expired
  • 138 Mark record has been deactivated
  • 146 Correction period expired
  • 148 Mark record has been deactivated
  • 154 Exception : user request to re-edit after changes
  • 164 Exception : mark record can be re-edited
  • 181 TREx applications will expire soon ($d days notice)
  • 182 TREx applications expired 
  • 190 POU will expire soon ($d days notice)
  • 191 Mark certificate will expire soon ($d days notice)
  • 196 Warning : Mark record about to be invalidated due to INCORRECT status time-out
  • 197 Your mark record is about to expire ($d days notice)
  • 199 Mark record transferred out/SMD has been revoked
  • 210 The domain name [$dn] was registered during sunrise
  • 220 The domain name [$dn] was registered during claims period
  • 230 The domain name [$dn] has been activated
  • 240 The domain name [$dn] has been registered in the Qualified Launch Program
  • 251 The variant name [$dn] has been activated
  • 310 SMD has been created
  • 320 SMD has been regenerated
  • 330 SMD has been revoked
  • 400 Account status has gone below watermark level ($level)
  • 500 UDRP/Court case status change

• The ID of the Trademark Record the poll message is referring to;
• The name of the Mark Record the poll message is referring to.

If the current poll message has been processed, you will need to send an acknowledgement. In the acknowledgement command you will need to use the ID of the current message, in order to de-queue the message and receive the next message.

In addition to the abovementioned notifications, a poll request can also provide you with a “watermark” message, if your pre-paid amount has gone below $1000.

Watermark messages contain the following elements:

• A counter that shows how many poll messages are in your queue;
• The ID of the current message (the message that is displayed);
• A message preceded by the message type unique identifier: “400 Account status has gone below watermark level”

You will also have to de-queue this message with an acknowledgement command in order to receive the next message.

Polling is available on both the production and OT&E environment.

In addition to this, the API v2 also automatically adds the number of poll messages pending in the responses that the API sends out.