Fiest Developers

List a menu's items and prices

Lists the items placed in one authorized menu, including each effective menu price and restaurant-wide base price.

GET/v1/restaurants/{restaurantId}/menus/{menuId}/items

Lists the items placed in one authorized menu, including each effective menu price and restaurant-wide base price. catalogItemId identifies the same catalog item across menus; menuId selects the menu whose prices are returned. effectivePriceMinor is the effective price in that menu, not the base price accepted by draft-item edits. Results are ordered by item UUID. Pass nextAfter as after until it is null. Organization-boundary tokens also require fiest.organization.read; when a token covers several organizations, organization_id must identify an exact organization returned by listOrganizations.

Quick request

curl -X GET "https://example.com/v1/restaurants/11111111-1111-4111-8111-111111111111/menus/43f64da8-4ec2-4900-b137-1c0927c975d2/items?organization_id=33333333-3333-4333-8333-333333333333" \  -H "Authorization: Bearer $FIEST_ACCESS_TOKEN"
{  "data": {    "restaurantId": "11111111-1111-4111-8111-111111111111",    "menuId": "43f64da8-4ec2-4900-b137-1c0927c975d2",    "currency": "EUR",    "items": [      {        "catalogItemId": "67fb6fb2-0f46-455b-934e-25707b77be08",        "name": "Margherita",        "description": "Tomato, mozzarella and basil",        "categoryId": "af16a392-f8a1-47b4-849f-4d707001e9b1",        "categoryName": "Pizza",        "effectivePriceMinor": 1450,        "basePriceMinor": 1350,        "priceSource": "menu_override",        "availability": "available",        "productType": "food",        "openPrice": false      }    ],    "truncated": false,    "nextAfter": null  }}

Authorization

fiestOAuth fiest.restaurant.read, fiest.menu.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.menu.read

Path Parameters

restaurantId*string

A restaurant identifier returned by the authorized restaurant list.

Formatuuid
menuId*string

The stable menu UUID returned by the menu list.

Formatuuid

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
after?string

The nextAfter UUID from the previous page.

Formatuuid
availability?string
Default"all"

Value in

  • "available"
  • "hidden"
  • "all"
limit?integer
Range1 <= value <= 50
Default50

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

application/json

Set the online-ordering menu

Makes a non-empty reviewed menu the restaurant online-ordering menu. Expected menu counts and the current online-menu ID prevent publishing stale state.

Add existing items to a draft menu

Adds up to 50 existing restaurant menu items to one inactive menu. Expected counts prevent applying the request to a menu that changed after review.