Limits and errors
Rate limits, the error format, and which errors are worth retrying.
Switched on per organisationThis is built and working, and is switched on for each organisation on request. Ask your account manager, or reply to any email from us naming it.
Limits
| Limit | Allowance |
|---|---|
| Requests | 60 a minute per set of credentials |
| Daily | 5,000 a day per organisation |
| Token requests | 10 a minute per set of credentials |
Every response carries RateLimit-Limit, RateLimit-Remaining and RateLimit-Reset. A 429 carries Retry-After: wait that many seconds, and back off further if it repeats.
Errors
{ "error": { "code": "invalid_token", "message": "The access token is missing, invalid, expired or revoked.", "request_id": "7f3c2a90-..." } }| Status | Code | Retry? |
|---|---|---|
| 400 | invalid_request | No. Fix the parameter, range or header |
| 401 | unauthorised, invalid_token | Get a new token once, then stop and check the credentials |
| 403 | insufficient_scope | No. The credentials do not include that scope |
| 404 | not_found | No |
| 405 | method_not_allowed | No. See the Allow header |
| 429 | rate_limited | Yes, after Retry-After |
| 500 | internal_error | Yes, with backoff. If it persists, contact us |
| 503 | service_unavailable | Yes, after Retry-After. The API is paused |
Every response carries X-Request-Id. Quote it when you contact support@alltoogether.com.