fetchOrder
Get ONE order by its OneTablet id (ONE-2744) — the read a webhook consumer makes the moment a delivery lands, to fetch the full record behind the event.
Org-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, and neither ever confirms that some other tenant holds that id. Same convention as every other unknown id on this API.
Request
- orderIdstring
OneTablet's identifier for the order (uuid) — the
Order.idevery webhook carries.
{
"orderId": "00000000-0000-0000-0000-000000000000"
}Responses
- orderOrder
The order. An object wrapper rather than a bare
Orderso later versions can add sibling fields additively — the same reason every other reply on this API is an object.
About Orders
Orders placed with your restaurants — read them, and act on them.
This is where an integration starts: poll fetchOrders for the orders OneTablet has accepted on your behalf across every delivery platform you are connected to, normalised into ONE shape regardless of whether they arrived from DoorDash, Uber Eats, Grubhub or a direct channel.
Two conventions hold everywhere on this API and are worth learning once. Money is always an integer in the currency's minor unit — 1250 is $12.50 — because a decimal total cannot survive a round trip through every language's default number type. Times are always ISO-8601 in UTC; a store's local time is a rendering decision, and the API does not make it for you.
All endpoints are POST with a single JSON body, and the path carries no version segment: evolution here is additive — new fields and new endpoints, never removals or narrowing (ONE-2596) — so there is no cutover a /v1 would ever mark.