GET /o/op/2/menu/load/{menuId}
O auth2

Returns details of a particular menu based on its unique identifier and other query parameters. Product modifier groups and product modifiers are always included in the response.

Migration from V1: The response includes menuModifierGroups on each menu item and deal item, containing product modifier details (name, price, extraPrice, sku, rich data). Items with product modifier groups are no longer marked as asSubItem.

Path parameters

  • menuId integer(int64) Required

    The unique identifier for the menu.

Query parameters

  • businessLocationId integer(int64) Required

    The unique identifier for the business location.

  • accountProfile string

    The order profile code. Item prices returned will be those associated with this order profile, when applicable. See the order profiles definition for more details.

    Default value is empty.

  • richContent boolean

    Query parameter to include rich content of menu items.

    Default value is false.

Responses

  • 200 application/json

    Successful retrieval of menu details including product modifiers.

    Hide response attributes Show response attributes object
    • menuName string

      The name of the menu.

    • menuEntryGroups array[object]

      Menu groups of this menu. The top-level entry will always be of type "group", representing a menu screen. Beneath each menuEntryGroup will be a menuEntry array containing any combination of one or more menu entries:

      • A menuItemEntry represents an individual item and may include product modifier groups.
      • A menuGroupEntry represents a menu sub-screen.
      • A menuDealEntry represents a combo.
      • A menuProductModifierEntry represents a product modifier.
      Hide menuEntryGroups attributes Show menuEntryGroups attributes object
      • @type string

        Indicates this is a menu group.

        Value is group.

      • id string

        The menu group ID.

      • name string

        The menu group name.

      • color string

        The color of the button in the POS.

      • menuEntry array[object]

        Array of menu entry objects.

        One of:
        menuItem object menuDeal object group object menuProductModifier object
    • richDataMissing boolean

      Indicates whether or not rich item data is missing, if requested.

    • ikentooMenuId integer(int64)

      The unique identifier for the menu.

    • conditionalTaxRules boolean

      Warning that actual tax depends on a POS Account condition and may be different from what is provided in this API.
  • 503 */*

    Service Unavailable

    Hide response attributes Show response attributes object
    • status string

      Value is 503.

    • timestamp string(date-time)
    • message string
    • apiSubExceptions array[object]
      Hide apiSubExceptions attributes Show apiSubExceptions attributes object
      • field string
      • rejectedValue string
      • message string
GET /o/op/2/menu/load/{menuId} 
curl \
 --request GET 'https://api.trial.lsk.lightspeed.app/o/op/2/menu/load/141948669132851?businessLocationId=45454565682155' \
 --header "Authorization: Bearer $ACCESS_TOKEN"
Response examples (200) 
{
  "menuName": "Main Menu",
  "menuEntryGroups": [
    {
      "@type": "group",
      "id": "141948669133028",
      "name": "Mains",
      "color": "blue",
      "menuEntry": [
        {
          "@type": "menuItem",
          "productName": "Burger",
          "productPrice": 10.0,
          "extraPrice": 1.99,
          "color": "blue",
          "sku": "25",
          "customItemNameEnabled": false,
          "pricingStrategy": "PRICE_CANNOT_BE_CUSTOMIZED",
          "itemRichData": {
            "squareImageUrl": "http://s3-eu-west-1.amazonaws.com/com.ikentoo.trial.rich-content-store/8262_2f6c1716-0f06-488c-afc2-d888666d94fb.image/png",
            "rawImageUrl": "http://s3-eu-west-1.amazonaws.com/com.ikentoo.trial.rich-content-store/8262_2f6c1716-0f06-488c-afc2-d888666d94fb_raw.image/png",
            "previewImageUrl": "http://s3-eu-west-1.amazonaws.com/com.ikentoo.trial.rich-content-store/8262_2f6c1716-0f06-488c-afc2-d888666d94fb_preview.image/png",
            "containsAlcohol": true,
            "alcoholPercentage": 13.0,
            "texts": [
              {
                "locale": "en",
                "friendlyDisplayName": "Burger - ENG",
                "description": "<p>Burger in english</p>"
              }
            ],
            "allergenCodes": [
              "mustard",
              "cereals"
            ]
          },
          "defaultTaxAmount": 1.5,
          "defaultTaxPercentage": 15.0,
          "taxIncludedInPrice": false,
          "conditionalTaxRules": true,
          "taxes": [
            {
              "description": "5% GST",
              "amount": 12.55,
              "percentage": 5.0
            }
          ],
          "asSubItem": true,
          "productionInstructionList": [
            {
              "multiSelectionPermitted": false,
              "productionInstructionGroupName": "Meat cooking",
              "productionIntructionGroupId": 236025632784487,
              "productionInstructionList": [
                {
                  "instruction": "Bleu",
                  "ikentooModifierId": 236025632784488
                },
                {
                  "instruction": "Rare",
                  "ikentooModifierId": 236025632784490
                },
                {
                  "instruction": "Medium Rare",
                  "ikentooModifierId": 236025632784492
                },
                {
                  "instruction": "Medium",
                  "ikentooModifierId": 236025632784494
                },
                {
                  "instruction": "Medium well",
                  "ikentooModifierId": 236025632784496
                },
                {
                  "instruction": "Well done",
                  "ikentooModifierId": 236025632784498
                }
              ]
            }
          ],
          "menuModifierGroups": [
            {
              "description": "Milk options",
              "sku": "30",
              "mustSelectAnItem": false,
              "multiSelectionPermitted": false,
              "minimumSelection": 0,
              "maximumSelection": 2,
              "itemRichData": {
                "squareImageUrl": "http://s3-eu-west-1.amazonaws.com/com.ikentoo.trial.rich-content-store/8262_2f6c1716-0f06-488c-afc2-d888666d94fb.image/png",
                "rawImageUrl": "http://s3-eu-west-1.amazonaws.com/com.ikentoo.trial.rich-content-store/8262_2f6c1716-0f06-488c-afc2-d888666d94fb_raw.image/png",
                "previewImageUrl": "http://s3-eu-west-1.amazonaws.com/com.ikentoo.trial.rich-content-store/8262_2f6c1716-0f06-488c-afc2-d888666d94fb_preview.image/png",
                "containsAlcohol": true,
                "alcoholPercentage": 13.0,
                "texts": [
                  {
                    "locale": "en",
                    "friendlyDisplayName": "Burger - ENG",
                    "description": "<p>Burger in english</p>"
                  }
                ],
                "allergenCodes": [
                  "mustard",
                  "cereals"
                ]
              },
              "productModifiers": [
                {
                  "@type": "menuProductModifier",
                  "productName": "Burger",
                  "productPrice": 10.0,
                  "extraPrice": 1.99,
                  "color": "blue",
                  "sku": "25",
                  "customItemNameEnabled": false,
                  "pricingStrategy": "PRICE_CANNOT_BE_CUSTOMIZED",
                  "itemRichData": {
                    "squareImageUrl": "http://s3-eu-west-1.amazonaws.com/com.ikentoo.trial.rich-content-store/8262_2f6c1716-0f06-488c-afc2-d888666d94fb.image/png",
                    "rawImageUrl": "http://s3-eu-west-1.amazonaws.com/com.ikentoo.trial.rich-content-store/8262_2f6c1716-0f06-488c-afc2-d888666d94fb_raw.image/png",
                    "previewImageUrl": "http://s3-eu-west-1.amazonaws.com/com.ikentoo.trial.rich-content-store/8262_2f6c1716-0f06-488c-afc2-d888666d94fb_preview.image/png",
                    "containsAlcohol": true,
                    "alcoholPercentage": 13.0,
                    "texts": [
                      {
                        "locale": "en",
                        "friendlyDisplayName": "Burger - ENG",
                        "description": "<p>Burger in english</p>"
                      }
                    ],
                    "allergenCodes": [
                      "mustard",
                      "cereals"
                    ]
                  },
                  "defaultTaxAmount": 1.5,
                  "defaultTaxPercentage": 15.0,
                  "taxIncludedInPrice": false,
                  "conditionalTaxRules": true,
                  "taxes": [
                    {
                      "description": "5% GST",
                      "amount": 12.55,
                      "percentage": 5.0
                    }
                  ],
                  "productionInstructionList": [
                    {
                      "multiSelectionPermitted": false,
                      "productionInstructionGroupName": "Meat cooking",
                      "productionIntructionGroupId": 236025632784487,
                      "productionInstructionList": [
                        {
                          "instruction": "Bleu",
                          "ikentooModifierId": 236025632784488
                        },
                        {
                          "instruction": "Rare",
                          "ikentooModifierId": 236025632784490
                        },
                        {
                          "instruction": "Medium Rare",
                          "ikentooModifierId": 236025632784492
                        },
                        {
                          "instruction": "Medium",
                          "ikentooModifierId": 236025632784494
                        },
                        {
                          "instruction": "Medium well",
                          "ikentooModifierId": 236025632784496
                        },
                        {
                          "instruction": "Well done",
                          "ikentooModifierId": 236025632784498
                        }
                      ]
                    }
                  ]
                }
              ]
            }
          ]
        }
      ]
    }
  ],
  "richDataMissing": false,
  "ikentooMenuId": 141948669132851,
  "conditionalTaxRules": true
}
Response examples (503) 
{
  "status": "503",
  "timestamp": "2026-05-04T09:42:00Z",
  "message": "string",
  "apiSubExceptions": [
    {
      "field": "string",
      "rejectedValue": "string",
      "message": "string"
    }
  ]
}