Fiest Developers

List restaurant catalog items

Pages through the restaurant's food and drink items, including items not placed in any menu.

GET/v1/restaurants/{restaurantId}/catalog-items

Pages through the restaurant's food and drink items, including items not placed in any menu. catalogItemId stays the same across catalog, menu, and sold menu_item reads. basePriceMinor is the restaurant-wide base price; use listMenuItems for an item's effective price in a selected menu. Products and product categories are not included. Results are ordered by catalogItemId. 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/catalog-items?organization_id=33333333-3333-4333-8333-333333333333" \  -H "Authorization: Bearer $FIEST_ACCESS_TOKEN"
{  "data": {    "restaurantId": "11111111-1111-4111-8111-111111111111",    "currency": "EUR",    "items": [      {        "catalogItemId": "67fb6fb2-0f46-455b-934e-25707b77be08",        "name": "Margherita",        "description": "Tomato, mozzarella and basil",        "categoryId": "af16a392-f8a1-47b4-849f-4d707001e9b1",        "categoryName": "Pizza",        "basePriceMinor": 1350,        "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

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 catalogItemId from the previous page.

Formatuuid
query?string

Optional case-insensitive item-name substring.

Length1 <= length <= 100
category_name?string

Optional exact, case-insensitive restaurant-wide category name.

Length1 <= length <= 100
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

Create a draft menu

Creates one empty inactive menu. It does not change the active POS or online-ordering menu.

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.