> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fire.rest/llms.txt
> Use this file to discover all available pages before exploring further.

# Order status notifications

> Receive order status updates from Fire.

As an order progresses through Fire (accepted, in preparation, ready, dispatched, etc.), Fire sends `order.status_changed` events to your webhook endpoint.

## Flow

```
Fire emits order.status_changed → Your system receives event → Your system acts on it
```

## Event payload

```json theme={null}
{
  "event": "order.status_changed",
  "data": {
    "fire_order_id": "fire_order_abc",
    "external_order_id": "uber_order_9876",
    "channel_id": "channel_abc123",
    "status": "in_preparation",
    "previous_status": "accepted",
    "updated_at": "2025-01-15T14:35:00Z"
  }
}
```

## Order statuses

| Status           | Description                           |
| ---------------- | ------------------------------------- |
| `received`       | Order injected successfully into Fire |
| `accepted`       | Restaurant accepted the order         |
| `in_preparation` | Kitchen started preparing the order   |
| `ready`          | Order is ready for pickup or dispatch |
| `dispatched`     | Handed to the delivery person         |
| `delivered`      | Delivered to the customer             |
| `cancelled`      | Order was cancelled                   |

## Processing steps

<Steps>
  <Step title="Verify the signature">
    Validate `X-Fire-Signature`. See [Authentication](/en/authentication).
  </Step>

  <Step title="Acknowledge immediately">
    Return `200 OK` before processing.
  </Step>

  <Step title="Look up the order">
    Use `external_order_id` to find the order in your system.
  </Step>

  <Step title="Act on the status change">
    Notify aggregators, update your database, trigger workflows — whatever your integration requires.
  </Step>
</Steps>

## Cancellations

If `status` is `cancelled`, act on it promptly. If your system relays orders to aggregators, some require cancellation confirmation within a short time window.