---
title: "Problem types"
description: "Every error answer of the API points with type at one of these pages. Each names the cause, the way out and an example answer."
lang: en
url: https://developers.bodo-app.com/en/problems/
apiVersion: 2026-11-01
---

# Problem types

Every error answer of the API points with type at one of these pages. Each names the cause, the way out and an example answer.

Branch on `code` in your client. Title and explanation come in the language of your `Accept-Language`, the code stays the same.

| Status | Code | Title |
| --- | --- | --- |
| 400 | [`INVALID_REQUEST`](/en/problems/INVALID_REQUEST/) | Invalid request |
| 400 | [`BATCH_TOO_LARGE`](/en/problems/BATCH_TOO_LARGE/) | Batch too large |
| 400 | [`CURSOR_MISMATCH`](/en/problems/CURSOR_MISMATCH/) | Cursor does not match the request |
| 400 | [`UNKNOWN_PARAMETER`](/en/problems/UNKNOWN_PARAMETER/) | Unknown parameter |
| 401 | [`UNAUTHENTICATED`](/en/problems/UNAUTHENTICATED/) | Not authenticated |
| 403 | [`FORBIDDEN`](/en/problems/FORBIDDEN/) | Forbidden |
| 403 | [`RISK_FAMILY_BLOCKED`](/en/problems/RISK_FAMILY_BLOCKED/) | Risk family blocked |
| 403 | [`ORGANIZATION_MISMATCH`](/en/problems/ORGANIZATION_MISMATCH/) | Organization mismatch |
| 403 | [`API_MODULE_DISABLED`](/en/problems/API_MODULE_DISABLED/) | Public API not enabled |
| 404 | [`NOT_FOUND`](/en/problems/NOT_FOUND/) | Not found |
| 404 | [`OPERATION_NOT_IN_VERSION`](/en/problems/OPERATION_NOT_IN_VERSION/) | Operation not available in this version |
| 409 | [`IDEMPOTENCY_IN_PROGRESS`](/en/problems/IDEMPOTENCY_IN_PROGRESS/) | Request with this Idempotency-Key still in progress |
| 409 | [`UPLOAD_INCOMPLETE`](/en/problems/UPLOAD_INCOMPLETE/) | Upload incomplete |
| 409 | [`WEBHOOK_ENDPOINT_LIMIT_REACHED`](/en/problems/WEBHOOK_ENDPOINT_LIMIT_REACHED/) | Too many webhook endpoints |
| 410 | [`VERSION_SUNSET`](/en/problems/VERSION_SUNSET/) | API version shut down |
| 412 | [`PRECONDITION_FAILED`](/en/problems/PRECONDITION_FAILED/) | Precondition failed |
| 422 | [`VALIDATION_FAILED`](/en/problems/VALIDATION_FAILED/) | Validation failed |
| 422 | [`IDEMPOTENCY_PAYLOAD_MISMATCH`](/en/problems/IDEMPOTENCY_PAYLOAD_MISMATCH/) | Idempotency-Key used with a different payload |
| 422 | [`UPLOAD_CHECKSUM_MISMATCH`](/en/problems/UPLOAD_CHECKSUM_MISMATCH/) | Upload checksum mismatch |
| 422 | [`UPLOAD_REJECTED`](/en/problems/UPLOAD_REJECTED/) | File rejected |
| 422 | [`BATCH_FAMILY_NOT_ALLOWED`](/en/problems/BATCH_FAMILY_NOT_ALLOWED/) | Family not allowed in a batch |
| 422 | [`WEBHOOK_URL_INVALID`](/en/problems/WEBHOOK_URL_INVALID/) | Invalid webhook URL |
| 428 | [`PRECONDITION_REQUIRED`](/en/problems/PRECONDITION_REQUIRED/) | Precondition required |
| 429 | [`RATE_LIMITED`](/en/problems/RATE_LIMITED/) | Too many requests |
| 429 | [`OVERLOADED`](/en/problems/OVERLOADED/) | Instance overloaded |
| 429 | [`QUOTA_EXHAUSTED`](/en/problems/QUOTA_EXHAUSTED/) | Quota exhausted |
| 500 | [`INTERNAL`](/en/problems/INTERNAL/) | Internal error |
| 502 | [`UPSTREAM`](/en/problems/UPSTREAM/) | Upstream service error |
| 503 | [`API_PAUSED`](/en/problems/API_PAUSED/) | API paused |
| 503 | [`INSTANCE_PENDING`](/en/problems/INSTANCE_PENDING/) | Instance is being updated |