Toast

Toast Orders API

Related to orders made by restaurant guests. For example, a restaurant guest orders items from a menu. Toast platform orders include one or more guest check.

GitHub OpenAPI
Business capability
Order Fulfilment Management BC-520.40

Operations 8

Each operation below carries the questions people ask an LLM about it and the instructions they give an agent to run it. Generated by API Evangelist overlay

POST /prices Calculate prices and taxes for an order · Toast Get Order Prices #
Ask an LLM
“What would the total, tax and service charges be for an order before submitting it?”
“Can I validate an order's pricing without actually placing it?”
Tell an agent
Price this order with dining option {dining_option} and checks {checks} at {restaurant}.
Calculate tax and service charges for checks {checks} without placing the order.
GET /orders/{guid} Look up one order · Toast Get an Order #
Ask an LLM
“Where can I see full details for a single order by its GUID?”
“What information comes back for one specific order?”
Tell an agent
Get order {guid} at restaurant {restaurant}.
Show me everything on order {guid}.
GET /ordersBulk Get full order details for a time period · Toast Get Multiple Orders #
Ask an LLM
“Can I download complete order details for every order opened in a business day?”
“What paging options exist when pulling many orders with full details?”
Tell an agent
Get all orders with full details at {restaurant} for business date {date}.
Fetch detailed orders opened between {start} and {end}, page {page}.
POST /orders/{orderGuid}/checks/{checkGuid}/selections Add items to an existing check · Toast Add Items to a Check #
Ask an LLM
“Is it possible to add more menu items to a check that is already open?”
“Can I append several selections to an existing order's check at once?”
Tell an agent
Add these items to check {check} on order {order}.
Append menu selections to check {check} of order {order} at {restaurant}.
PATCH /orders/{orderGuid}/deliveryInfo Update an order's delivery details · Toast Update Delivery Information #
Ask an LLM
“Can I mark a delivery order as dispatched or delivered?”
“Can I change the driver assigned to a delivery order?”
Tell an agent
Set delivery state of order {order} to {state}.
Assign delivery employee {employee} to order {order} and note {notes}.
POST /orders/{orderGuid}/void Void an order · Toast Void an Order #
Ask an LLM
“How do I void an order along with its items and payments?”
“Which orders are eligible to be voided based on payment type?”
Tell an agent destructive · confirm first
Void order {order} at restaurant {restaurant}.
Void order {order} including selections {selections} and payments {payments}.
POST /orders Place a new order · Toast Post an Order #
Ask an LLM
“How do I submit a new order to a restaurant?”
“What does an order need at minimum to be accepted, like dining option and checks?”
Tell an agent
Place an order at {restaurant} with dining option {dining_option} and checks {checks}.
Submit a delivery order with checks {checks} and delivery info {delivery}.
GET /orders List order GUIDs for a period (deprecated) · Toast Get Order Identifiers (deprecated) #
Ask an LLM
“Is there an older endpoint that returns only the GUIDs of orders opened in a time window?”
“What is the longest time span the deprecated order ID list supports?”
Tell an agent
List order GUIDs at {restaurant} for business date {date} using the deprecated endpoint.
Get just the order IDs opened between {start} and {end}.

Documentation

📖
Documentation
https://doc.toasttab.com/openapi/orders/overview/
📖
Documentation
https://doc.toasttab.com/openapi/menus/overview/
📖
Documentation
https://doc.toasttab.com/openapi/labor/overview/
📖
Documentation
https://doc.toasttab.com/openapi/restaurants/overview/
📖
Documentation
https://doc.toasttab.com/openapi/stock/overview/
📖
Documentation
https://doc.toasttab.com/openapi/partners/overview/
📖
Documentation
https://doc.toasttab.com/openapi/authentication/overview/

Specifications

⚙
OpenAPI
https://raw.githubusercontent.com/api-evangelist/toast/refs/heads/main/openapi/toast-orders-api-openapi.yml

Work with this as data

Every API here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for apis

7 MCP tools reach this
  • find_apisBrowse and filter every API in the catalog.
  • get_api_artifactsOne API's artifacts, grouped by type.
  • get_openapiThe primary OpenAPI for this API.
  • find_similar_apisAPIs that look like this one.
  • apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
  • resolveTurn a domain, URL or GitHub org into the provider it belongs to.
  • find_cohortsEvery scored population of providers in the catalog.
All 92 tools →

Call it yourself

curl for this page
This API 
curl "https://apis.io/api/v1/apis/toast:toast-orders-api"
All apis 
curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

toast-orders-api-openapi.yml Raw ↑ 
openapi: 3.2.0
info:
  version: 2.9.0
  title: Toast Orders API
  description: 'The orders API includes operations that create, update, and retrieve information about restaurant

    guest orders.'
  contact:
    name: Toast developer support
servers:
- url: https://toast-api-server/orders/v2
tags:


# --- truncated at 32 KB (114 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/toast/refs/heads/main/openapi/toast-orders-api-openapi.yml