---
title: "Problem-Typen"
description: "Jede Fehlerantwort der API zeigt mit type auf eine dieser Seiten. Jede nennt Ursache, Ausweg und eine Beispielantwort."
lang: de
url: https://developers.bodo-app.com/problems/
apiVersion: 2026-11-01
---

# Problem-Typen

Jede Fehlerantwort der API zeigt mit type auf eine dieser Seiten. Jede nennt Ursache, Ausweg und eine Beispielantwort.

Verzweige im Client auf `code`. Titel und Erklärung kommen in der Sprache deines `Accept-Language`, der Code bleibt gleich.

| Status | Code | Titel |
| --- | --- | --- |
| 400 | [`INVALID_REQUEST`](/problems/INVALID_REQUEST/) | Ungültige Anfrage |
| 400 | [`BATCH_TOO_LARGE`](/problems/BATCH_TOO_LARGE/) | Batch zu groß |
| 400 | [`CURSOR_MISMATCH`](/problems/CURSOR_MISMATCH/) | Cursor passt nicht zur Anfrage |
| 400 | [`UNKNOWN_PARAMETER`](/problems/UNKNOWN_PARAMETER/) | Unbekannter Parameter |
| 401 | [`UNAUTHENTICATED`](/problems/UNAUTHENTICATED/) | Nicht authentifiziert |
| 403 | [`FORBIDDEN`](/problems/FORBIDDEN/) | Keine Berechtigung |
| 403 | [`RISK_FAMILY_BLOCKED`](/problems/RISK_FAMILY_BLOCKED/) | Risikofamilie gesperrt |
| 403 | [`ORGANIZATION_MISMATCH`](/problems/ORGANIZATION_MISMATCH/) | Organisation passt nicht |
| 403 | [`API_MODULE_DISABLED`](/problems/API_MODULE_DISABLED/) | Öffentliche API nicht freigeschaltet |
| 404 | [`NOT_FOUND`](/problems/NOT_FOUND/) | Nicht gefunden |
| 404 | [`OPERATION_NOT_IN_VERSION`](/problems/OPERATION_NOT_IN_VERSION/) | Operation in dieser Version nicht verfügbar |
| 409 | [`IDEMPOTENCY_IN_PROGRESS`](/problems/IDEMPOTENCY_IN_PROGRESS/) | Anfrage mit diesem Idempotency-Key läuft noch |
| 409 | [`UPLOAD_INCOMPLETE`](/problems/UPLOAD_INCOMPLETE/) | Upload nicht abgeschlossen |
| 409 | [`WEBHOOK_ENDPOINT_LIMIT_REACHED`](/problems/WEBHOOK_ENDPOINT_LIMIT_REACHED/) | Zu viele Webhook-Endpunkte |
| 410 | [`VERSION_SUNSET`](/problems/VERSION_SUNSET/) | API-Version abgeschaltet |
| 412 | [`PRECONDITION_FAILED`](/problems/PRECONDITION_FAILED/) | Vorbedingung nicht erfüllt |
| 422 | [`VALIDATION_FAILED`](/problems/VALIDATION_FAILED/) | Validierung fehlgeschlagen |
| 422 | [`IDEMPOTENCY_PAYLOAD_MISMATCH`](/problems/IDEMPOTENCY_PAYLOAD_MISMATCH/) | Idempotency-Key mit anderem Inhalt |
| 422 | [`UPLOAD_CHECKSUM_MISMATCH`](/problems/UPLOAD_CHECKSUM_MISMATCH/) | Prüfsumme des Uploads stimmt nicht |
| 422 | [`UPLOAD_REJECTED`](/problems/UPLOAD_REJECTED/) | Datei abgewiesen |
| 422 | [`BATCH_FAMILY_NOT_ALLOWED`](/problems/BATCH_FAMILY_NOT_ALLOWED/) | Familie im Batch nicht erlaubt |
| 422 | [`WEBHOOK_URL_INVALID`](/problems/WEBHOOK_URL_INVALID/) | Webhook-URL ungültig |
| 428 | [`PRECONDITION_REQUIRED`](/problems/PRECONDITION_REQUIRED/) | Vorbedingung erforderlich |
| 429 | [`RATE_LIMITED`](/problems/RATE_LIMITED/) | Zu viele Anfragen |
| 429 | [`OVERLOADED`](/problems/OVERLOADED/) | Instanz ausgelastet |
| 429 | [`QUOTA_EXHAUSTED`](/problems/QUOTA_EXHAUSTED/) | Kontingent erschöpft |
| 500 | [`INTERNAL`](/problems/INTERNAL/) | Interner Fehler |
| 502 | [`UPSTREAM`](/problems/UPSTREAM/) | Fehler im nachgelagerten Dienst |
| 503 | [`API_PAUSED`](/problems/API_PAUSED/) | API pausiert |
| 503 | [`INSTANCE_PENDING`](/problems/INSTANCE_PENDING/) | Instanz wird aktualisiert |