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

# API v1 errors

> Handle API v1 error responses.

API v1 keeps the legacy error response shape:

```json theme={null}
{
  "success": false,
  "message": "Missing API key"
}
```

Read both the HTTP status and the `message` field.

## Status codes

| Status | Meaning                                                                                     |
| -----: | ------------------------------------------------------------------------------------------- |
|  `400` | The request is malformed, a required parameter is missing, or validation failed.            |
|  `401` | The API key is missing or invalid.                                                          |
|  `404` | The requested resource was not found.                                                       |
|  `409` | The request matched more than one company.                                                  |
|  `422` | The resource exists but cannot be used for the requested operation.                         |
|  `500` | An unexpected server error occurred. Retry with backoff if the operation is safe to repeat. |

Treat `400`, `401`, `404`, and `422` as client-correctable errors. Retry only
after you change the request.