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

​
Error response

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

​
Common status codes

StatusMeaning
400The request is invalid.
401Authentication is missing or invalid.
403The request is not allowed.
404The resource was not found.
409The request conflicts with existing data.
422Validation failed.
500An 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 Simfy Business ID returned by the API. This makes reconciliation and support investigation much easier.