Error codes

All Firmium API endpoints require a valid API key. These codes can appear in responses.

400 – Bad Request

The request is malformed or incomplete.

{
  "error": "Ungültige Anfrageparameter",
  "code": "bad_request"
}

The token is missing, invalid, or expired.

{
  "error": "Ungültiges oder abgelaufenes Token",
  "code": "unauthorized"
}

You are authenticated but not allowed to perform this action.

{
  "error": "Unzureichende Berechtigungen",
  "code": "forbidden"
}

The requested resource does not exist.

{
  "error": "Nicht gefunden",
  "code": "not_found"
}

The request conflicts with existing state, for example creating a resource that already exists.

{
  "error": "Konflikt: Ressource existiert bereits",
  "code": "conflict"
}

The rate limit was exceeded.

{
  "error": "Rate limit exceeded. Please try again later or log in for higher limits.",
  "limit": 100,
  "reset_in": 42,
  "reset_at": "12:34:56"
}

An unexpected error occurred. Retry later.

{
  "error": "Interner Serverfehler",
  "code": "server_error"
}