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.

How to add the items to the check

To add items to an existing check, you send a POST request to the /orders/{orderGuid}/checks/{checkGuid}/selections endpoint. To identify the items to add, you provide a JSON array of Selection objects.

To add items to an existing check

  1. Find the Toast platform GUIDs of the order and the check that you are adding items to.

    • The response from the POST request to create an order contains the order and check GUIDs.

    • If you know the order GUID, you can send a GET request to get the order details, which include the check GUID. See Getting detailed information about one order.

    • If you do not know the order GUID, you can send a GET request to get the details for orders that were updated during a specific time interval. See Getting detailed information about multiple orders. The order details include the order and check GUIDs.

  2. Create a JSON array of Selection objects that contain information about the items you are adding, including modifiers. For an example, see Example request message body to add an item to an existing check.

  3. Send a POST request to the /orders/{orderGuid}/checks/{checkGuid}/selections endpoint of the Orders API.


    In the POST request path parameters, include the Toast platform GUIDs of the order and the check.


    In the request message body, include the array of Selection objects.

  4. Examine the response that you receive from the Orders API. Verify that your request processed successfully with a 200 HTTP code response. For an example, see Example response after adding items to an existing check.