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.

Toast rate limit values

Here are the current rate limits for Toast APIs. These rate limits are described in more detail in How rate limiting works.

Global rate limit

20 requests per second, 10,000 requests per 15 minutes

The global rate limit limits the total number of requests that an API client can make across all APIs collectively.

For example, if your client makes 3 requests to the orders API, and 7 requests to the labor API, it made a total of 10 requests against the Toast APIs collectively.

Default API rate limit

20 requests per second, 10,000 requests per 15 minutes

API rate limits are used to limit requests to individual Toast APIs.

Note

The global and default API rate limits are currently the same, but might differ in the future.

There are no custom API rate limits for specific APIs.

Endpoint-specific rate limits

The GET /menus endpoint of the menus API uses an endpoint rate limit for each client of one request per second per location. Requests that your API client makes for one restaurant do not affect the client's rate limits for any other restaurant.

The GET /metadata endpoint uses the default API rate limit of 20 requests per second, 10,000 requests per 15 minutes.

The GET /ordersBulk endpoint of the orders API uses an endpoint rate limit of five requests per client per location per second.