Errors
Errors are JSON with a stable machine code in error
(and often a sentence in message). Never parse the sentence.
Example
{
"error": "rate_limited",
"limit": 600,
"message": "More than 600 calls in a minute. Try again in 12 seconds.",
"retry_after": 12
}
| Status | error | Meaning |
|---|---|---|
| 401 | invalid_api_key | No key, or the key is wrong, revoked or past its rotation grace. |
| 403 | insufficient_scope | The key is valid but lacks the scope this endpoint needs. |
| 429 | rate_limited | More calls in a minute than the organization's limit. |
| 403 | ekyc_required | The key's issuer is not verified for a transacting call. |
| 404 | not_found | No such record for your organization. |