Fiest Developers

Get order details

Returns one order by the opaque order_id returned by findOrders, including stable sold-line IDs, catalog UUIDs, selected options, sale-time tax evidence, and bounded…

GET/v1/restaurants/{restaurantId}/orders/{orderId}

Returns one order by the opaque order_id returned by findOrders, including stable sold-line IDs, catalog UUIDs, selected options, sale-time tax evidence, and bounded paymentReferences for successful Viva, SumUp and Stripe payments, including linked tab and card splits. Provider transaction IDs, transaction codes, checkout/session IDs and stored amounts are read from retained evidence; missing IDs remain null. Stripe sale-session evidence has no stored payment-intent ID. paymentReferences is null when the database read is unavailable; an empty payments array means no retained matching references. These references are not a refund, fee or settlement ledger and do not contain card data or provider credentials.

Quick request

curl -X GET "https://example.com/v1/restaurants/11111111-1111-4111-8111-111111111111/orders/fiest-50b6d34f-bc6e-4248-b3d6-839b3dda31a1?organization_id=33333333-3333-4333-8333-333333333333" \  -H "Authorization: Bearer $FIEST_ACCESS_TOKEN"
{  "data": {    "restaurantId": "11111111-1111-4111-8111-111111111111",    "currency": "EUR",    "order": {      "orderId": "fiest-50b6d34f-bc6e-4248-b3d6-839b3dda31a1",      "receiptHash": "fiest-50b6d34f-bc6e-4248-b3d6-839b3dda31a1",      "restaurantOrderNumber": 1042,      "occurredAt": "2026-07-15T10:42:00.000Z",      "businessDate": "2026-07-15",      "orderType": "dine_in",      "tableNumber": 12,      "status": "paid",      "paymentMethod": "card",      "orderOrigin": {        "kind": "fiest",        "provider": null      },      "originalAmountMinor": 1350,      "totalAmountMinor": 1350,      "vatMinor": 161,      "refundAmountMinor": 0,      "discountAmountMinor": 0,      "items": [        {          "lineId": "7fbb7bd1-661c-4a1e-9748-acde61280973",          "catalogItemId": "67fb6fb2-0f46-455b-934e-25707b77be08",          "catalogItemKind": "menu_item",          "catalogCategoryId": "af16a392-f8a1-47b4-849f-4d707001e9b1",          "menuId": "43f64da8-4ec2-4900-b137-1c0927c975d2",          "name": "Margherita",          "category": "Pizza",          "itemType": "food",          "quantity": 1,          "unitPriceMinor": 1350,          "originalUnitPriceMinor": null,          "grossAmountMinor": 1350,          "discountAmountMinor": 0,          "vatAmountMinor": 161,          "taxEvidence": "snapshot",          "taxCountryCode": "FI",          "taxRatesAsOf": "2026-07-15",          "vatRates": [            {              "category": "reduced",              "rateBps": 1350,              "vatAmountMinor": 161            }          ],          "selectedOptions": [            {              "optionId": "5378e830-a342-4f45-8793-f3eef0a3b063",              "optionGroupId": "437e9ca5-8daf-411a-b371-0bedb5ecb263",              "name": "Extra cheese",              "quantity": 1,              "unitPriceMinor": 100,              "grossAmountMinor": 100,              "vatAmountMinor": 12            }          ]        }      ],      "itemsTruncated": false,      "grossSalesMinor": 1350,      "netSalesMinor": 1189,      "vatAllocationMethod": "stored",      "vatBreakdown": {        "countryCode": "FI",        "ratesAsOf": "2026-07-15",        "rows": [          {            "category": "reduced",            "rateBps": 1350,            "grossAmountMinor": 1350,            "netAmountMinor": 1189,            "vatAmountMinor": 161          }        ]      },      "tipAmountMinor": 0,      "paymentReferences": {        "payments": [          {            "provider": "viva",            "receiptHash": "fiest-50b6d34f-bc6e-4248-b3d6-839b3dda31a1",            "checkoutId": "11111111-1111-4111-8111-111111111111",            "transactionId": "22222222-2222-4222-8222-222222222222",            "transactionCode": null,            "sessionId": "11111111-1111-4111-8111-111111111111",            "recordedAmountMinor": 1350,            "currency": "EUR",            "createdAt": "2026-07-15T10:42:00.000Z",            "evidence": "payment_tracking"          }        ],        "truncated": false      },      "refundedItems": [],      "refundedItemsTruncated": false    }  }}

Authorization

fiestOAuth fiest.restaurant.read, fiest.orders.read
AuthorizationBearer <token>

OAuth 2.1 authorization code with PKCE. Partner clients and redirect URIs must be approved by Fiest before use.

In: header

Scope: fiest.restaurant.read, fiest.orders.read

Path Parameters

restaurantId*string

A restaurant identifier returned by the authorized restaurant list.

Formatuuid
orderId*string

Opaque non-sequential order identifier returned by the order list.

Length1 <= length <= 255

Query Parameters

organization_id?string

An organizationId returned by GET /v1/organizations. Required for restaurant-scoped calls when a Management portfolio authorization covers more than one organization; omitted for a single-restaurant authorization and optional for a one-organization grant.

Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

Find orders

Returns newest-first order summaries. Exact order_id lookup and cursor browsing may search all history; partial or operational filters require an inclusive date range of at…

List menus

Returns named menus and their POS and online selection state. A menu selects items from the restaurant catalog and may have its own price for each selected item.