Response Object

The error object has the following json structure:

{
  "status": 404,
  "code": "not_found",
  "message": "Your desired resource was not found",
  "errors": [],
  "type": "error"
}

As you can see you will receive a object with the appropriate http status code in number and text format.
You will also receive a localized message that you can directly display to the user.
The message is localized depending on the „Accept-Language“ http header in the request.
If there where any nested errors you will find them in the „errors“ field.
Example for validation error:

{
  "status": 400,
  "code": "bad_request",
  "message": "Ihre Anfrage ist falsch bzw. unvollständig",
  "errors": [
    {
      "reason": "PARAMETER",
      "name": "arg1",
      "message": "darf nicht null sein"
    }
  ],
  "type": "error"
}