Skip to main content

Errors

The API uses conventional HTTP status codes. Error responses are JSON:

StatusMeaning
400Validation failed — message is "Validation error" and errors lists the offending fields.
401Missing or invalid API token.
404Resource not found (or not owned by your account), including an id in the request body — message names it, for example "Asset not found".
409Conflict with the current state of a resource.
429Rate limit exceeded — see Rate limits.
500Unexpected 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" }