Rate Limits

Rate limits keep the API fast and reliable for everyone. Every endpoint allows up to 60 requests per minute.

EndpointsLimit
All endpoints60 requests / minute

How requests are counted

  • The limit applies over a rolling window. You can make up to 60 requests in any 60-second period, not just in each calendar minute.
  • Requests are counted per organization, so every API key and connected app acting on the same organization shares the limit.
  • Documents and records such as invoices, bills, payments and contacts each have their own limit, so requests to one don't count toward another's. Settings endpoints, such as accounts, tax rates, branches and projects, share one limit.
  • There are no daily or monthly limits.

When you exceed the limit

The API responds with 429 Too Many Requests, and the Retry-After header tells you how many seconds to wait before trying again.

HTTP/1.1 429 Too Many Requests
Retry-After: 12

To stay within the limit:

  • Wait for the number of seconds in Retry-After before retrying a request that returned 429.
  • Spread large imports and syncs out over time instead of sending requests in bursts.
  • Use pagination to fetch more records per request, rather than requesting records one by one.