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

# Errors

> Understand common Finup API error responses.

Errors use an HTTP status code and a JSON body.

```json theme={null}
{
  "status_code": 400,
  "error_message": "Validation failed"
}
```

| Status | Meaning                                     |
| ------ | ------------------------------------------- |
| `400`  | Invalid request or business rule error      |
| `401`  | Missing or invalid credentials              |
| `403`  | Authenticated user does not have permission |
| `404`  | Resource not found                          |
| `409`  | State conflict                              |
| `420`  | Insufficient balance                        |
| `429`  | Rate limit exceeded                         |

<Tip>
  Log the HTTP status, request id if present, endpoint, and sanitized request metadata. Do not log API keys, tokens, full card data, or customer secrets.
</Tip>