Get menu items

post

/bi/v1/{orgIdentifier}/getMenuItemDimensions

Gets menu item dimensions for a specified location.

Request

Path Parameters
Body ()
The request body defines the details of the API request.
Root Schema : locRequestPayload
Type: object
Request payload with location reference
Show Source
  • Title: Application Name
    Maximum Length: 128
    The name of the application which is accessing the API.

    First Available Version: 20.1.10

  • Title: Include
    List of objects to include in response
  • Title: Location Reference
    The location reference, this may be a store number or name depending on the organization
  • Title: Search Criteria
    Search criteria to filter results based on field value
Back to Top

Response

Supported Media Types

200 Response

OK
Body ()
Root Schema : menuItemDimensions
Type: object
The response body contains information about the menu item dimensions for the specified location
Show Source
Nested Schema : Menu Items
Type: array
Title: Menu Items
An array of menu item dimensions
Show Source
Nested Schema : menuItem
Type: object
The response body contains information about the menu item for the specified location.
Show Source
  • Title: Category
    Maximum Length: 99
    The category of the menu item. This attribute will not be returned in the response if value is null
  • Title: Category Group Hierarchy #1 assigned to the master item
    Maximum Length: 40
    Category Group Hierarchy #1 assigned to the master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group Hierarchy #2 assigned to the master item
    Maximum Length: 40
    Category Group Hierarchy #2 assigned to the master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group Hierarchy #3 assigned to the master item
    Maximum Length: 40
    Category Group Hierarchy #3 assigned to the master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group Hierarchy #4 assigned to the master item
    Maximum Length: 40
    Category Group Hierarchy #4 assigned to the master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group #1 assigned to the master item
    Maximum Length: 20
    Category Group #1 assigned to the master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group #2 assigned to the master item
    Maximum Length: 20
    Category Group #2 assigned to the master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group #3 assigned to the master item
    Maximum Length: 20
    Category Group #3 assigned to the master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group #4 assigned to the master item
    Maximum Length: 20
    Category Group #4 assigned to the master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Do Not Include In Sales
    Identifies if the menu item is not to be included in sales. This attribute will not be returned in the response if value is false or null
  • Title: External reference 1 that corresponds to an identifier in a third party system
    Maximum Length: 32
    External reference 1 that corresponds to an identifier in a third party system. This attribute is optional. This attribute will not be returned in the response if value is null.

    First Available Version 20.2

  • Title: External reference 2 that corresponds to an identifier in a third party system
    Maximum Length: 32
    External reference 2 that corresponds to an identifier in a third party system. This attribute is Optional optional. This attribute will not be returned in the response if value is null.

    First Available Version 20.2

  • Title: Faily Group Master Name
    Maximum Length: 99
    The name of this menu item's family group master
  • Title: Family Group Master Number
    Maximum Length: 16
    The number of this menu item's family group master
  • Title: Family Group Name
    Maximum Length: 99
    The name of this menu item's family group
  • Title: Family Group Number
    Maximum Length: 16
    The number of this menu item's family group
  • Title: Category Group Hierarchy #1 assigned to the family group master item
    Maximum Length: 40
    Category Group Hierarchy #1 assigned to the family group master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group Hierarchy #2 assigned to the family group master item
    Maximum Length: 40
    Category Group Hierarchy #2 assigned to the family group master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group Hierarchy #3 assigned to the family group master item
    Maximum Length: 40
    Category Group Hierarchy #3 assigned to the family group master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group Hierarchy #4 assigned to the family group master item
    Maximum Length: 40
    Category Group Hierarchy #4 assigned to the family group master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group #1 assigned to the family group master item
    Maximum Length: 20
    Category Group #1 assigned to the family group master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group #2 assigned to the family group master item
    Maximum Length: 20
    Category Group #2 assigned to the family group master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group #3 assigned to the family group master item
    Maximum Length: 20
    Category Group #3 assigned to the family group master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group #4 assigned to the family group master item
    Maximum Length: 20
    Category Group #4 assigned to the family group master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Major Group Master Name
    Maximum Length: 99
    The name of this menu item's major group master
  • Title: Major Group Master Number
    Maximum Length: 16
    The number of this menu item's major group master
  • Title: Major Group Name
    Maximum Length: 99
    The name of this menu item's major group
  • Title: Major Group Number
    Maximum Length: 16
    The number of this menu item's major group
  • Title: Category Group Hierarchy #1 assigned to the major group master item
    Maximum Length: 40
    Category Group Hierarchy #1 assigned to the major group master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group Hierarchy #2 assigned to the major group master item
    Maximum Length: 40
    Category Group Hierarchy #2 assigned to the major group master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group Hierarchy #3 assigned to the major group master item
    Maximum Length: 40
    Category Group Hierarchy #3 assigned to the major group master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group Hierarchy #4 assigned to the major group master item
    Maximum Length: 40
    Category Group Hierarchy #4 assigned to the major group master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group #1 assigned to the major group master item
    Maximum Length: 20
    Category Group #1 assigned to the major group master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group #2 assigned to the major group master item
    Maximum Length: 20
    Category Group #2 assigned to the major group master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group #3 assigned to the major group master item
    Maximum Length: 20
    Category Group #3 assigned to the major group master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Category Group #4 assigned to the major group master item
    Maximum Length: 20
    Category Group #4 assigned to the major group master item. This attribute will not be returned in the response if value is null.

    First Available Version 20.1.14.13

  • Title: Master Name
    Maximum Length: 99
    The master menu item name
  • Title: Master Number
    Maximum Length: 16
    The master menu item number
  • Title: Name
    Maximum Length: 99
    Menu item name
  • Title: Name 2
    Maximum Length: 99
    Menu Item Name 2. This attribute will not be returned in the response if value is null
  • Title: Name 2 Master Name
    Maximum Length: 99
    The master menu item name of menu item name2
  • Title: Name 2 Master Number
    Maximum Length: 16
    The master menu item number of menu item name2
  • Title: Number
    Maximum Length: 16
    Menu item number
  • Title: Revenue Flag
    A flag indicating if the Menu Item is revenue or non-revenue Menu Item. This attribute will not be returned in the response if value is true or null

400 Response

Bad Request
Body ()
Root Schema : exceptionDetailType
Type: object
Exception details
Show Source

401 Response

Unauthorized
Body ()
Root Schema : exceptionDetailType
Type: object
Exception details
Show Source

403 Response

Service Unavailable
Body ()
Root Schema : exceptionDetailType
Type: object
Exception details
Show Source

404 Response

Resource Not Found
Body ()
Root Schema : exceptionDetailType
Type: object
Exception details
Show Source

Default Response

Unexpected Error
Body ()
Root Schema : exceptionDetailType
Type: object
Exception details
Show Source
Back to Top

Examples

The following example shows how to get the menu item dimensions for a specified location by submitting a POST request on the REST resource using cURL. For more information, see Use cURL

curl -i -X POST -H "Authorization: Bearer 
  
   " -H "Content-Type:application/json" -d {"locRef":"1234"} https://baseurl/bi/v1/orgidentifier/getMenuItemDimensions 
  

Example of Response Header

The following shows an example of the response header.

HTTP/1.1 200 OK  Date: Tue, 20 Oct 2020 21:24:33 GMT  Transfer-Encoding: chunked  Content-Type: application/json

Example of Response Body

The following example shows the contents of the response body in JSON format:

{
 "locRef": "1234,
 "menuItems":[{
  "num": 15253,
  "name: "Hamburger",
  "catGrpHierName1": "Menu Item Category Hierarchy 1",
  "catGrpName1": "Menu Item Category Group 1",
  "catGrpHierName2": "Menu Item Category Hierarchy 2",
  "catGrpName2": "Menu Item Category Group 2",
  "catGrpHierName3": "Menu Item Category Hierarchy 3",
  "catGrpName3": "Menu Item Category Group 3",
  "catGrpHierName4": "Menu Item Category Hierarchy 4",
  "catGrpName4": "Menu Item Category Group 4",
  "majGrpNum": 49469,
  "majGrpName": "Food",
  "famGrpNum": 261486,
  "famGrpName": "Sides",
  "majGrpMstrNum": 49469,
  "majGrpMstrName": "Food",
  "mgCatGrpHierName1": "Major Group Category Hierarchy 1",
  "mgCatGrpName1": "Major Group Category Group 1",
  "mgCatGrpHierName2": "Major Group Category Hierarchy 2",
  "mgCatGrpName2": "Major Group Category Group 2",
  "mgCatGrpHierName3": "Major Group Category Hierarchy 3",
  "mgCatGrpName3": "Major Group Category Group 3",
  "mgCatGrpHierName4": "Major Group Category Hierarchy 4",
  "mgCatGrpName4": "Major Group Category Group 4",
  "famGrpMstrNum": 261486,
  "famGrpMstrName": "Sides",
  "fgCatGrpHierName1": "Family Group Category Hierarchy 1",
  "fgCatGrpName1": "Family Group Category Group 1",
  "fgCatGrpHierName2": "Family Group Category Hierarchy 2",
  "fgCatGrpName2": "Family Group Category Group 2",
  "fgCatGrpHierName3": "Family Group Category Hierarchy 3",
  "fgCatGrpName3": "Family Group Category Group 3",
  "fgCatGrpHierName4": "Family Group Category Hierarchy 4",
  "fgCatGrpName4": "Family Group Category Group 4",
  "doNotIncludeInSales": false,
  "category": "Gift Card",
  "revFlag": true
  "extRef1": "567abc",
  "extRef2": "789def01"
  }]
}
Back to Top