Orders API prevents inappropriately large orders from being posted

The orders API has been updated to return an HTTP status code 400 response when a client integration attempts to:

• Post an order with more than 1,000 top-level selections.

• Post an item to an order that causes the order to have more than 1,000 top-level selections. For example, if an order has 995 top-level selections and your integration posts six items to that order in a single request, that request will be rejected.

A top-level selection is defined as a selection that is not the child of another selection in the order.

To avoid exceeding the 1,000 top-level selection limit, Toast support encourages the grouping of identical items together, so:

• 1 soda

• 1 lemonade

• 1 energy drink

• 1 soda

• 1 lemonade

• 1 soda

Can be combined into:

• 3 sodas

• 2 lemonades

• 1 energy drink

This reduces the number of top-level selections in the request from six to three while providing the same order data.