Get Menu

GET

https://api.npretail.app/:tenant/:environment/:company/restaurant/:restaurantId/menu/:menuId

GET

/:tenant/:environment/:company/restaurant/:restaurantId/menu/:menuId

curl https://api.npretail.app/01234567-89ab-cdef-0123-456789abcdef/production/CRONUS%2520International%2520Ltd./restaurant/e7b7e6b6-e3b7-f011-a901-f68f27c8de7a/menu/e7b7e6b6-e3b7-f011-a901-f68f27c8de7a \
     -H "x-np-api-key: <NaviPartner API Key>"

200ExampleGetMenu

{
  "id": "e7b7e6b6-e3b7-f011-a901-f68f27c8de7a",
  "code": "QR_MENU",
  "startTime": "09:00:00",
  "endTime": "18:00:00",
  "timezone": "(UTC+01:00) Brussels, Copenhagen, Madrid, Paris",
  "active": true,
  "lastUpdated": "2026-01-15T14:30:00Z",
  "menuContent": {
    "categories": [
      {
        "code": "DURUM",
        "sortKey": 10000,
        "title": {
          "DAN": "Durum",
          "ENU": "Durum"
        },
        "description": {
          "DAN": "Hjemmelavet fladbrød hver morgen",
          "ENU": "Homemade flatbread every morning"
        },
        "items": [
          {
            "itemCode": "10000",
            "variantCode": "",
            "sortKey": 10000,
            "unitPrice": 120,
            "title": {
              "DAN": "Durum Kebab",
              "ENU": "Durum Kebab"
            },
            "descriptionMarkdown": {
              "DAN": "# Overskrift\nlavet med kærlighed",
              "ENU": "# Headline\nMade with love"
            },
            "nutritionMarkdown": {
              "DAN": "kcal per 100g: For mange",
              "ENU": "kcal per 100g: Too many"
            },
            "status": "Active",
            "addonItems": [
              {
                "category": "PROTEIN",
                "sortKey": 1,
                "type": "Select",
                "mandatory": false,
                "fixedQuantity": false,
                "quantityPerUnit": false,
                "quantity": 0,
                "itemCode": "",
                "variantCode": "",
                "unitPrice": 0,
                "description": {},
                "selectOptions": [
                  {
                    "sortKey": 10000,
                    "fixedQuantity": true,
                    "quantityPerUnit": true,
                    "quantity": 1,
                    "itemCode": "10011",
                    "variantCode": "",
                    "unitPrice": 0,
                    "description": {
                      "DAN": "Kebab fyld",
                      "ENU": "Kebab filling"
                    }
                  },
                  {
                    "sortKey": 20000,
                    "fixedQuantity": true,
                    "quantityPerUnit": true,
                    "quantity": 1,
                    "itemCode": "10012",
                    "variantCode": "",
                    "unitPrice": 0,
                    "description": {
                      "DAN": "Falafel fyld",
                      "ENU": "Falafel filling"
                    }
                  }
                ]
              },
              {
                "category": "EXTRAS",
                "sortKey": 1,
                "type": "Quantity",
                "mandatory": false,
                "fixedQuantity": false,
                "quantityPerUnit": false,
                "quantity": 0,
                "itemCode": "10006",
                "variantCode": "",
                "unitPrice": 15,
                "description": {
                  "DAN": "Ekstra fyld",
                  "ENU": "Extra filling"
                }
              }
            ],
            "upsellItems": [
              {
                "itemCode": "10018",
                "variantCode": "",
                "sortKey": 10000,
                "unitPrice": 80,
                "title": {},
                "descriptionMarkdown": {},
                "nutritionMarkdown": {},
                "status": "Active"
              }
            ]
          }
        ]
      }
    ],
    "checkoutUpsellItems": [
      {
        "itemCode": "10024",
        "variantCode": "",
        "sortKey": 20000,
        "unitPrice": 4,
        "title": {
          "DAN": "plastikpose",
          "ENU": "plasticbag"
        },
        "descriptionMarkdown": {
          "DAN": "",
          "ENU": ""
        },
        "nutritionMarkdown": {
          "DAN": "",
          "ENU": ""
        },
        "status": "Active"
      }
    ],
    "addonCategories": {
      "PROTEIN": {
        "sortKey": 1,
        "title": {
          "DAN": "Protein",
          "ENU": "Protein"
        },
        "description": {
          "DAN": "Protein beskrivelse",
          "ENU": "Protein description"
        }
      },
      "EXTRAS": {
        "sortKey": 3,
        "title": {
          "DAN": "Tilvalg",
          "ENU": "Extras"
        },
        "description": {
          "DAN": "",
          "ENU": ""
        }
      }
    }
  }
}

Get a specific menu with full details including categories, items, addons, and translations

Authentication

x-np-api-keystring

API Key authentication via header

Path parameters

tenantstringRequired

Your Entra Tenant ID. More details.

environmentstringRequired

Your Business Central Environment. More details.

companystringRequired

Your Business Central Company. More details.

restaurantIdUUIDRequired

The restaurant system ID

menuIdUUIDRequired

The menu system ID

Query parameters

vatBusinessPostingGroupstringOptional

Optional VAT Business Posting Group override. When provided, each menu item’s unit price is recomputed using the VAT Posting Setup formed by this override + the item’s VAT Product Posting Group instead of the item’s default VAT setup. Typical use: exposing EU / international VAT-exempt prices to self-service clients. Returns 400 if the override is not a known VAT Business Posting Group, or if a menu item’s VAT Product Posting Group has no matching VAT Posting Setup under the override — in the latter case the error text names the offending item so the caller can surface it directly.

Response

This endpoint returns an object.

idUUID

The unique system identifier for the menu

codestring

The menu code

startTimestring

When the menu becomes active (HH:MM:SS format)

endTimestring

When the menu stops accepting orders (HH:MM:SS format)

timezonestring

The timezone for the menu times

activeboolean

Whether the menu is currently active

lastUpdateddatetime

Cache key for the menu payload (UTC). Moves whenever anything the payload carries changes, prices included, and is never older than the start of the server day.

menuContentobject

Complete menu structure with categories, items, and upsells

Authentication

Path parameters

Headers

Query parameters

Response