Errors - Rivo Business API Docs

Rivo Business uses HTTP status codes and a consistent JSON response body.

Error response

{
  "status": "error",
  "message": "Invalid token",
  "data": null
}

Common status codes

Status	Meaning
`400`	The request is invalid.
`401`	Authentication is missing or invalid.
`403`	The request is not allowed.
`404`	The resource was not found.
`409`	The request conflicts with existing data.
`422`	Validation failed.
`500`	An internal server error occurred.

Best practice

Always check both the HTTP status code and the response status field before processing data. For value-moving flows, store the Rivo ID returned by the API. This makes reconciliation and support investigation much easier.