Order Status Updates

Send order status updates to Gett when orders progress through your system.

Data Flow

POST /orders/{orderId}/status

{
  "status": "confirmed",
  "estimatedReadyAt": "2026-01-13T13:30:00Z"
}

Field	Type	Required	Description
`status`	string	✅	See status values below
`estimatedReadyAt`	datetime	❌	Expected ready time
`cancelReason`	string	❌	Required if cancelling

Status	When to Send
`confirmed`	Order accepted into your system
`preparing`	Kitchen has started making the order
`ready`	Order is ready for pickup
`picked_up`	Courier has collected the order
`completed`	Order successfully delivered
`cancelled`	Order cannot be fulfilled

If you need to cancel an order:

{
  "status": "cancelled",
  "cancelReason": "Item out of stock"
}