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

# Error Codes

> HTTP status codes returned by the API and what they mean.

All errors follow the standard response envelope with `"status": "failed"`:

```json theme={null}
{
  "http_code": 404,
  "status": "failed",
  "message": "Lead not found."
}
```

## Status codes

| Code  | Meaning                                                                                |
| ----- | -------------------------------------------------------------------------------------- |
| `400` | Bad request — malformed body or missing required field. Check `message` for specifics. |
| `401` | Missing or invalid API key.                                                            |
| `403` | Valid key but missing required scope, or attempting to access another agency's data.   |
| `404` | Resource not found, or it doesn't belong to your agency.                               |
| `409` | Conflict — e.g. duplicate contact email for the same lead, or max API keys reached.    |
| `429` | Rate limit exceeded. See [Rate Limits](/rate-limits).                                  |
| `500` | Internal server error. If this persists, contact support.                              |