Guides
Guides

Order Event: status_change

This event notification when the status of an order is updated.

Response Parameters for status_change (order)

If the request is successful, the attributes associative array may include the
following:

Parameter nameObligationDefinition/Value
order_reg_typeAlways returned.

The updated status of the order.

Possible values include:
  • landrush new premium renewal sunrise transfer whois_privacy
order_statusAlways returned.

The status or the order.

Possible values include:

  • Processed* - Applies to trades and transfers and means we are waiting on an owner or registry to take action.

  • Completed* - All required actions have taken place and the order is successfully completed.

  • Pending* - An order that has been explicitly saved by the reseller, or has failed validation and has been automatically saved. General Availability pre-orders are also 'saved' in pending before they are automatically processed. Please note that all domain orders start in a pending state regardless of whether they were saved.

  • Waiting* - Order is asynchronous and is in progress. A couple of examples where this would happen would be due to a waiting async GDPR consent request, or an asynchronous response received from the registry.

  • Pending_fax* - is no longer in use. The system will generally not automatically clear out pending orders. There are a couple of scenarios where it will though:
    If an order for a domain is submitted any orders saved in pending for the same domain will be canceled.
    In the RWI there is the option to cancel pending/declined orders created more than X days ago. This is also available via API via cancel_pending_orders call.)

  • Declined* - Order was canceled after being submitted. Some examples would be a registrant not accepting a claim notice, async GDPR notice, or transfer notice.

  • Canceled* - Order has been canceled by reseller via API or RWI. Pending/Declined order canceled by the system due to a duplicate order/taken domain.

Example Response for status_change

<?xml version='1.0' encoding="UTF-8" standalone="no" ?>
<!DOCTYPE OPS_envelope SYSTEM "ops.dtd">
<OPS_envelope>
    <header>
        <version>0.9</version>
    </header>
    <body>
        <data_block>
            <dt_assoc>
                <item key="protocol">XCP</item>
                <item key="object">EVENT</item>
                <item key="response_code">200</item>
                <item key="is_success">1</item>
                <item key="response_text">Command successful</item>
                <item key="transaction_id">2014-06-19 11:31:49 27660 101</item>
                <item key="action">REPLY</item>
                <item key="attributes">
                    <dt_assoc>
                        <item key="events">
                            <dt_array>
                                <item key="0">
                                    <dt_assoc>
                                        <item key="object_data">
                                            <dt_assoc>
                                                <item key="domain_name">tucows-13e97b6ef1b1c.com</item>
                                                <item key="order_status">pending</item>
                                                <item key="order_reg_type">new</item>
                                                <item key="order_id">701980</item>
                                            </dt_assoc>
                                        </item>
                                        <item key="object">ORDER</item>
                                        <item key="event_id">39232348265486a2ac352d349cd88a3f</item>
                                        <item key="event">STATUS_CHANGE</item>
                                        <item key="event_date">2014-06-19T15:31:47Z</item>
                                    </dt_assoc>
                                </item>
                            </dt_array>
                        </item>
                        <item key="total">6</item>
                    </dt_assoc>
                </item>
            </dt_assoc>
        </data_block>
    </body>
</OPS_envelope>
{
   "created_date" : "2026-07-15T23:53:22Z",
   "id" : "c7abdb68-53b8-4ce5-baed-f17a1ab8c00e",
   "notification_type" : "opensrs.order.status_change",
   "payload" : {
      "@type" : "type.googleapis.com/google.protobuf.Struct",
      "value" : {
         "event" : "STATUS_CHANGE",
         "event_date" : "2026-07-15T23:53:22Z",
         "event_id" : "502d06dd948600303e5099e3aa086262",
         "object" : "ORDER",
         "object_data" : {
            "domain_id" : "98876632",
            "domain_name" : "example.com",
            "order_reg_type" : "renewal",
            "order_status" : "completed"
         }
      }
   }
}

Updated 4 days ago