Errors
Error format and status codes.
Errors are JSON with a machine error code and a human message:
{ "error": "quota_exceeded", "message": "plan 'free' allows up to 1 active mint slot" }
Status codes
| Status | error | When |
|---|---|---|
| 400 | invalid_mint / invalid_query / invalid_body | Malformed mint, query param, or request body. |
| 401 | unauthorized | Missing/invalid x-api-key on a keyed route. |
| 402 | quota_exceeded / network_not_allowed | At your plan's slot ceiling, or plan can't use the network. |
| 404 | token_not_found / not_subscribed | Unknown mint, or releasing a mint you don't hold. |
| 409 | slot_locked | Release blocked by the commitment lock — wait or pass ?rotate=true. |
| 503 | *_unavailable / service_unavailable | A datastore is briefly unreachable — retry. |
| 500 | internal | Unexpected error — retry; if it persists, contact support. |