Overview
The EPP message queue provides asynchronous notifications for events that occur outside of direct Registrar commands, such as transfer approvals, rejections, and domain purges.
Enabling the Message Queue
The message queue can be enabled or disabled via the Account Settings page of the Registrar Console. The Console also provides a web interface for viewing queued messages.
Supported Message Types
- Notification of approved inbound transfer — sent when the losing Registrar approves or the 5-day auto-approval triggers.
- Notification of rejected inbound transfer — sent when the losing Registrar explicitly rejects the transfer.
- Notification of new outbound transfer — sent to the losing Registrar when a transfer request is initiated.
- Notification of cancelled outbound transfer — sent when a pending transfer is cancelled.
- Domain purge notification — sent when a domain in pendingDelete status is finally purged from the database.
Processing Messages
Use the EPP <poll> command to retrieve messages. Messages must be acknowledged with <poll op='ack'> to be removed from the queue (response code 1301 indicates a pending message). Each message contains domain transfer status data including domain name, transfer status, requesting Registrar ID, action date, and new expiry date.
Best Practice
Poll the message queue regularly (e.g. every few minutes) to ensure timely processing of transfer events. Unacknowledged messages remain in the queue. Use the Registrar Console for manual monitoring of the queue if your automated polling fails.
Related Articles
- How to Transfer a .CO Domain Between Registrars
- EPP Commands Reference