Rate limits

Starting work is rate-limited, per user. Reading — status, history, data — is not.

The limit is a fixed one-minute window, counted separately for each user — so each integration with its own user and key gets its own budget.

Bulk exports have a separate limit: one at a time per account and company. A second concurrent export also returns 429, with Retry-After: 5.

When you're limited

You get 429 Too Many Requests, with a Retry-After header saying how many seconds to wait:

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

Wait that long, then retry the same request.

async function withRetry(send) {
  for (;;) {
    const response = await send()
    if (response.status !== 429) return response
    const seconds = Number(response.headers.get("Retry-After") ?? 1)
    await new Promise((resolve) => setTimeout(resolve, seconds * 1000))
  }
}