Get one order
Get one order by its Sous Chef id. Use it when a webhook arrives, to fetch the full record behind the event.
Scoped to the organization your api key resolves to. An orderId that belongs to another organization is indistinguishable from one that does not exist: both are 404. Every other unknown id on this API follows the same convention.
Safe to retry: this operation is read-only and idempotent.
Request
- orderIdstring
Sous Chef's identifier for the order (uuid): the
Order.idevery order webhook carries.
{
"orderId": "00000000-0000-0000-0000-000000000000"
}Responses
Headers
- x-mealco-tx-idstringoptional
The correlation id for this call, returned on every response that an operation produces, successful or not. Quote it when you report a problem so that we can trace the request. You may send your own x-mealco-tx-id on the request and it is used as the id. It is optional in the schema because a request with a malformed JSON body is rejected before an id is assigned, so that one response carries neither this header nor the txId field of the error body.
- orderOrder
The order. It is wrapped in an object, like every other reply on this API, so that fields can be added without a breaking change.
{
"order": {
"id": "00000000-0000-0000-0000-000000000000",
"platformOrderId": "00000000-0000-0000-0000-000000000000",
"status": "new",
"deliveryStatus": "ASSIGNED",
"createdAt": "2026-01-01T00:00:00Z",
"updatedAt": "2026-01-01T00:00:00Z",
"estimatedReadyAt": "2026-01-01T00:00:00Z",
"rejectReason": "<rejectReason>",
"rejectReasonCode": "itemOutOfStock",
"store": {
"id": "00000000-0000-0000-0000-000000000000",
"externalId": "00000000-0000-0000-0000-000000000000",
"location": "<location>",
"brand": "<brand>",
"platform": "<platform>"
},
"cancellation": {
"by": "<by>",
"reason": "<reason>",
"reasonCode": "itemOutOfStock",
"at": "2026-01-01T00:00:00Z"
},
"details": {
"externalId": "00000000-0000-0000-0000-000000000000",
"externalReadableOrderNum": "<externalReadableOrderNum>",
"placedAt": "2026-01-01T00:00:00Z",
"estimatedPickupAt": "2026-01-01T00:00:00Z",
"isPickup": true,
"isMerchantDelivery": true,
"subtotal": 50,
"tax": 50,
"tip": 50,
"deliveryFee": 50,
"total": 50,
"items": [
{}
],
"promotions": [
{}
]
}
}
}About Orders
Read the orders placed with your restaurants.
Start an integration here. Poll fetchOrders for the orders Sous Chef has accepted on your behalf across every delivery platform you are connected to. Orders are normalized into one shape, whether they arrived from DoorDash, Uber Eats, Grubhub or a direct channel.
Two conventions hold everywhere on this API. Money is always an integer in the currency's minor unit: 1250 is $12.50. Times are always ISO-8601 in UTC. The API does not convert them to a store's local time.
All endpoints are POST with a single JSON body, and the path carries no version segment. Changes to this API are additive (new fields and new endpoints, never removals or narrowing), so there is no versioned cutover.