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

# Errors

> Understand YoLead Public API error responses.

Errors return a stable JSON shape:

```json theme={null}
{
  "code": 40001,
  "message": "Validation error"
}
```

| Status | Meaning                                                             |
| ------ | ------------------------------------------------------------------- |
| `400`  | Validation or business-rule error.                                  |
| `401`  | Invalid credentials, stale timestamp, or bad signature.             |
| `403`  | API key scope is not sufficient.                                    |
| `404`  | Entity does not exist or is not accessible for the API key company. |
| `409`  | Request conflicts with the current entity state.                    |
| `500`  | Unexpected server error.                                            |