Errors
The API uses conventional HTTP status codes. Error responses are JSON:
| Status | Meaning |
|---|---|
400 | Validation failed — message is "Validation error" and errors lists the offending fields. |
401 | Missing or invalid API token. |
404 | Resource not found (or not owned by your account), including an id in the request body — message names it, for example "Asset not found". |
409 | Conflict with the current state of a resource. |
429 | Rate limit exceeded — see Rate limits. |
500 | Unexpected server error — message is "Internal server error", with no further detail. |
Each endpoint's reference lists the errors it can return, with their schemas.
Every error body carries a message string. The HTTP status code is on the
response itself, not repeated in the body.
Example validation error:
{
"message": "Validation error",
"errors": ["amount: must not be less than 0"]
}
errors entries are field: reason (for example accountId: must be a UUID).
Other errors carry message alone:
{ "message": "Not Found" }