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.

Required information to add the discount

Before you can add a discount to a check or a menu item selection, you need the following information:

  • The GUID of the order.

  • The GUID of the check.

  • If you are adding a discount to a menu item selection, the GUID of the menu item selection.

You also create an array of AppliedDiscount objects for the discounts you are adding. You can optionally provide promotional codes for the discounts.

For example:

    "discount": {
      "guid": "a96fd992-9d69-4a62-894f-b621c31127a5"2
    "discount": {
      "guid": "30430bb7-0e55-4aae-b783-ee62cda3ca7d"3
    "appliedPromoCode": "MYEXTRASPECIALOFFER"


You can include multiple discounts in the JSON array.


The Toast platform identifier of one of the discounts that is being added to a check or menu item selection.


The identifier of another discount that is being added.