API call limits and throttles

Call limits and throttles for the REST API

Note

Important

Apps that are in the Builder tier of the Intuit App Partner Program have an included limit of 500,000 CorePlus API calls per workspace per month. API calls beyond that limit will be throttled and an HTTP 429 error will be returned. For details see this article.

The following table describes the call limits and throttles for the QuickBooks Online REST API.

Server	REST API endpoints	Batch endpoint
Sandbox servers	500 requests per minute per realm ID. 10 requests per second, per realm ID and app. 40 emails per day per Realm.	Recommended maximum number of payloads in a single batch request is 30. Throttled at 40 Batch requests per minute, per realm ID and app. 120 Batch requests per minute per realm ID.
Production servers	500 requests per minute per realm ID. 10 requests per second, per realm ID and app.	Recommended maximum number of payloads in a single batch request is 30. Throttled at 40 Batch requests per minute, per realm ID and app. 120 Batch requests per minute per realm ID.

If your app accesses endpoints other than QuickBooks Online, there is a combined limit of 800 requests per minute, per realm ID and app.
You’ll see HTTP Status Code 429 when throttling occurs. If you see this, wait 60 seconds before retrying the request.
Any requests that take longer than 120 seconds to execute will time out. Keep this in mind when determining how many payloads to include in a single batch request.
The maximum number of entities returned in a query response is 1000. To handle more than 1000, use pagination to fetch the entities in chunks.
Each transaction (except Journal Entry) can contain a maximum of 10,000 line items.
Each transaction (except Journal Entry) can be linked to a maximum of 10,000 transactions (includes transaction-level and line-level links).
Each transaction (except Journal Entry) can contain a maximum of 10,000 attachments.

Note: Requests are performed in a mutli-threaded environment. There may be timing issues leading to unexpected results.

Call limits and throttles for the GraphQL API

The following table describes the call limits and throttles for the QuickBooks Online GraphQL API.

Server GraphQL endpoints

Sandbox and production servers

500 requests per minute per realm ID.

800 requests per minute per app.