Error codes
Every error type this API returns, with its HTTP status.
type is the stable, machine-readable field to branch on. code narrows it further per-endpoint (see each endpoint's own Errors table) — both are safe to parse; message is not.
| Status | type |
|---|---|
| 400 | invalid_requestThe request body or query failed validation. |
| 401 | unauthorizedMissing or invalid Bearer token. |
| 403 | forbiddenValid token, but missing the required scope. |
| 404 | not_foundThe resource doesn't exist or doesn't belong to this user. |
| 409 | conflictThe request conflicts with the resource's current state. |
| 422 | insufficient_balanceWallet balance is too low for this operation. |
| 429 | rate_limitedToo many requests — see Rate limits. |
| 500 | internal_errorAn unexpected server error — safe to retry. |