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

# Errors

> Standard error responses from the Finance API

## HTTP status codes

| Code  | Meaning                                              |
| ----- | ---------------------------------------------------- |
| `200` | Success                                              |
| `400` | Bad request — missing or invalid field               |
| `401` | Unauthorized — missing, expired, or invalid token    |
| `403` | Forbidden — token valid but insufficient permissions |
| `404` | Resource not found                                   |
| `500` | Internal server error                                |

## Error body

All errors return a JSON body with a `message` field:

```json theme={null}
{
  "message": "No token provided."
}
```

## Common errors

| Message                                              | Cause                           | Fix                                         |
| ---------------------------------------------------- | ------------------------------- | ------------------------------------------- |
| `No token provided.`                                 | `x-access-token` header missing | Add the header                              |
| `Unauthorized! Access Token was expired!`            | Token older than 24 h           | Re-authenticate                             |
| `Customer not found`                                 | `customerid` does not exist     | Verify the ID via `/finance/customers`      |
| `Deal not found`                                     | `dealid` does not exist         | Verify via `/finance/deals`                 |
| `WHERE parameter 'id' has invalid 'undefined' value` | Required body field missing     | Check required fields in the request schema |