Get applicable discounts

Returns an array of ApplicableDiscount objects that contain information about the discounts that apply to the checks and menu item selections in an order. Each ApplicableDiscount object contains information that you can use to determine which items and checks are eligible for the discount. If you include a promoCode value in the ApplicableDiscount object, the applicableDiscounts endpoint returns the only the discounts that are associated with the promotional code that you supply.

Request
header Parameters
Toast-Restaurant-External-ID
required
string

The identifier of the restaurant.

Request Body schema: application/json

A JSON ApplicableDiscountsRequest object containing information about an order, and an optional promoCode.

required
object (schemas)

A Toast order is composed of multiple 'Check's. Each check has multiple item 'Selection's.

promoCode
string

An optional promotional code. If you include a promotional code, the applicableDiscounts endpoint returns only discounts that are associated with that promotional code.

Responses
200

A JSON array of ApplicableDiscount objects.

400

Invalid arguments

500

An unexpected internal error occurred. There is a requestId attached to this error that can be referenced by Toast.

post/applicableDiscounts
Request samples
application/json
{
  • "order": {
    },
  • "promoCode": "string"
}
Response samples
application/json
[
  • {
    }
]