Rate limits
The per-key limit, its headers, and the four ways to be told to slow down.
The limit
Calls are counted per API key, per minute, within your organisation’s own limit. Your limit is not a published figure: it is in the X-RateLimit-Limit header of every answer past authentication.
Headers
| Header | What it says |
|---|---|
X-RateLimit-Limit | Requests allowed per minute by the limit that applied to this call: the key's, or the organisation's when that one was reached first. |
X-RateLimit-Remaining | Requests left in that limit after this one, rounded down. |
X-RateLimit-Reset | Seconds until the limit is full again. A duration, not a timestamp. |
They come with every answer past authentication, including errors, and not with a 401.
When you are told to slow down
Four different budgets answer 429, and they are not retried the same way. RATE_LIMITED sends Retry-After in seconds. QUOTA_EXCEEDED does not clear by waiting: the allowance refills when more is bought.
| Code | Status | Meaning | Retrying |
|---|---|---|---|
CONCURRENCY_LIMIT | 429 | Too many simultaneous requests. | Safe to retry |
FLOW_GRANT_EXHAUSTED | 429 | That flow grant has no uses left. | Do not retry automatically |
FLOW_RUN_LIMIT_REACHED | 429 | Too many flow runs are active. | Safe to retry |
OCR_QUEUE_SATURATED | 429 | The document queue is full. Retry shortly. | Safe to retry |
QUOTA_EXCEEDED | 429 | The allowance for this window is spent. | Do not retry automatically |
RATE_LIMITED | 429 | Too many requests. | Safe to retry |
Written from FinSour platform API contract (finsour development at 80e8b83bf), last changed . OpenAPI document at commit 436311c32, API version 2026-11-01. The beta is served from the staging gateway.