- DATE:
- AUTHOR:
- The Toast - API team
- RELATED ROADMAP ITEMS:
- Tender API check information matches orders API check information
Tender API will use orders API check object
On 2025-06-23, the tender API will change the way it represents Toast POS checks in requests it makes to your integration. On 2025-06-23, the Check
object in some tender API requests will reflect Toast POS checks in the same way that the orders API represents guest checks. This will fix some current problems with tender API Check
object information.
This change to the tender API behavior will affect the information about guest checks that you receive from the integration. For example:
The
appliedServiceCharges
array in the tender APICheck
object will include anAppliedServiceCharge
object for each service charge on the check. Currently, the array is empty even when a check includes service charges.The
totalAmount
value in the tender APICheck
object will correctly include the total price of the check, including taxes and discounts. Currently, this value is alwaysnull
.The
amount
value in the tender APICheck
object will correctly include the check price after discounts but before tax. Currently theamount
value includes the check price after discounts and after taxes.The
modifiers
array in the tender APISelection
object will include aSelection
object for each modifier for a menu item selection. Currently, the array is empty even when a menu item selection includes modifiers.
This change does not affect all tender API request types. Some request types already use the orders API check object behavior, some request types will change the check behavior on 2025-06-23, and one type will not change the check behavior. The following table describes which request types are changing check behavior and when the changes will happen.
The change to the tender API Check
object is currently deployed in the Toast API sandbox environment. Verify that your tender API integration handles the updated guest check information in the sandbox environment before the change is deployed in the production environment on 2025-06-23.
For more information about the tender API, see Tender provider integrations overview.