Troubleshooting empty and missing menu data

The menus API can return an empty response or a response with missing menu items under certain location configuration conditions. Before investigating an API issue, verify that the location's menu configuration is correct in Toast Web.

Common causes for empty or incomplete menu responses include:

  • The location has not published their menu configuration. The menus API returns menu data based on the most recently published configuration. If the location has never published their menus, or has unpublished menu changes, the API may return no menus or may not reflect recent edits. For more information, see API updates may require publishes.

  • The Toast-Restaurant-External-ID header contains an incorrect location GUID. The menus API returns data for the specific location identified in this header. If the GUID is incorrect, the response may be empty or may contain data for a different location.

For more information about retrieving menu data and available request parameters, see Menus API overview.