The Tripleseat Open API allows you to retrieve Menus and manage Menu Item Selections associated with Events.
Menus are read-only and provide configuration data. Menu Item Selections represent menu items actively attached to a specific Event.
Menus Endpoints
Menus are read-only and return menu metadata along with associated menu items.
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/menus | Retrieve all menus for the current site or customer |
| GET | /v1/menus/{id} | Retrieve a specific menu by ID |
List Menus
GET /v1/menus
Optional Query Parameters
| Parameter | Description |
|---|---|
page | Page number for pagination |
per_page | Number of results per page |
Example
GET /v1/menus?page=1&per_page=25 Authorization: Bearer YOUR_ACCESS_TOKEN
Retrieve a Single Menu
GET /v1/menus/{id}
GET /v1/menus/10 Authorization: Bearer YOUR_ACCESS_TOKEN
Menu Object Fields
| Field | Type | Description |
|---|---|---|
id | Integer | Menu identifier |
site_id | Integer | Associated site ID |
location_ids | Array<Integer> | Locations where this menu is available |
display_name | String | Public-facing menu name |
internal_name | String | Internal system name |
description | String | Menu description |
delivery_options | String | Available delivery options |
disabled | Boolean | Whether the menu is disabled |
menu_items | Array | Menu items included in the menu |
Menu Item Selections Endpoints
Menu Item Selections represent menu items selected and attached to a specific Event.
| Method | Endpoint | Description |
|---|---|---|
| GET | /v1/events/{event_id}/menu_item_selections | Retrieve all menu item selections for an event |
| GET | /v1/events/{event_id}/menu_item_selections/{id} | Retrieve a specific menu item selection |
List Menu Item Selections
GET /v1/events/{event_id}/menu_item_selections
GET /v1/events/200/menu_item_selections Authorization: Bearer YOUR_ACCESS_TOKEN
Retrieve a Single Menu Item Selection
GET /v1/events/{event_id}/menu_item_selections/{id}
GET /v1/events/200/menu_item_selections/55 Authorization: Bearer YOUR_ACCESS_TOKEN
Menu Item Selection Object Fields
| Field | Type | Description |
|---|---|---|
id | Integer | Selection ID |
parent_type | String | Parent object type |
parent_id | Integer | Parent object ID |
menu_item_id | Integer | Menu item identifier |
quantity | Integer | Quantity selected |
price | String (decimal) | Price per item |
total_price | String (decimal) | Total price for selection |
display_name | String | Public-facing name |
internal_name | String | Internal name |
created_at | DateTime | Creation timestamp |
updated_at | DateTime | Last updated timestamp |
Error Handling
401 – Unauthorized
- Missing token
- Invalid token
- Expired token
404 – Not Found
- Menu ID does not exist
- Event ID does not exist
- Menu Item Selection ID does not exist
Important Limitations
- Menus are read-only via the Open API.
- Menu Item Selections are read-only via the Open API.
- Creating, updating, or deleting menus or menu item selections is not supported.