> ## Documentation Index
> Fetch the complete documentation index at: https://docs.firmium.de/llms.txt
> Use this file to discover all available pages before exploring further.

# Error codes

> HTTP error codes returned by the Firmium API

# 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.

```json theme={null}
{
  "error": "Ungültige Anfrageparameter",
  "code": "bad_request"
}
```

## 401 – Unauthorized

The token is missing, invalid, or expired.

```json theme={null}
{
  "error": "Ungültiges oder abgelaufenes Token",
  "code": "unauthorized"
}
```

## 403 – Forbidden

You are authenticated but not allowed to perform this action.

```json theme={null}
{
  "error": "Unzureichende Berechtigungen",
  "code": "forbidden"
}
```

## 404 – Not Found

The requested resource does not exist.

```json theme={null}
{
  "error": "Nicht gefunden",
  "code": "not_found"
}
```

## 409 – Conflict

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

```json theme={null}
{
  "error": "Konflikt: Ressource existiert bereits",
  "code": "conflict"
}
```

## 429 – Too Many Requests

The rate limit was exceeded.

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

## 500 – Internal Server Error

An unexpected error occurred. Retry later.

```json theme={null}
{
  "error": "Interner Serverfehler",
  "code": "server_error"
}
```