This guide will be removed on April 29, 2022. Please use our new, easier-to-use Toast technical documentation site. All updated content is on the new site.

POSTing the discounts to the check or menu item selection

When you add discounts to an existing order, you send a POST message to the /appliedDiscounts endpoint for the check or the menu item selection.

The REST API request path parameters must include the following Toast platform GUIDs:

  • The GUID of the order.

  • The GUID of the check.

  • If applicable, the GUID of the menu item selection.

Use the following endpoints to add discounts to an existing order:

Check-level discounts

To add check-level discounts, send the POST message to:


Item-level discounts

To add an item-level discount, send the POST message to:


The body of the message is the JSON array of AppliedDiscount objects.