Rate limits & quotas
Limits apply per user, across all of that user's keys.
| Limit | Value | When exceeded |
|---|---|---|
| Request rate | 10 requests/second (burst 20) | 429 rate_limited |
| Monthly quota | 50,000 requests per calendar month | 429 quota_exceeded |
| Page size | max 100 records per page | 400 |
Handling 429
Back off and retry with exponential delay. A 429 body tells you which
limit you hit via its code field.
{
"type": "about:blank",
"title": "THROTTLED",
"status": 429,
"code": "rate_limited",
"detail": "...",
"request_id": "..."
}Good citizenship
- Cache catalog responses (
/v1/catalog/*) — they rarely change. - Use
page_size=100when syncing large datasets. - Avoid tight polling loops; poll at most every few minutes.