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

# Errors

> HTTP status codes returned by the Elite Prospects API.

The Elite Prospects API uses standard HTTP status codes.

## Status codes

| Status                  | Meaning                                           | Common causes                                                                                               |
| ----------------------- | ------------------------------------------------- | ----------------------------------------------------------------------------------------------------------- |
| `200 OK`                | Success.                                          | —                                                                                                           |
| `400 Bad Request`       | The request was malformed.                        | Unknown field requested via `fields`, unsupported filter, invalid sort key, out-of-range numeric parameter. |
| `401 Unauthorized`      | Missing or invalid `apiKey`.                      | Key not provided, key revoked, typo.                                                                        |
| `403 Forbidden`         | The resource isn't included in your subscription. | The endpoint, region, season, or category isn't part of your plan — see [Coverage](/coverage).              |
| `404 Not Found`         | The route or resource does not exist.             | Wrong path, unknown id or slug.                                                                             |
| `429 Too Many Requests` | Rate limit exceeded.                              | Sending requests faster than your plan allows.                                                              |
| `5xx Server Error`      | Server-side problem.                              | Transient — retry with backoff.                                                                             |

## Handling errors

```javascript theme={null}
const response = await fetch(url);
if (!response.ok) {
  const body = await response.json().catch(() => ({}));
  throw new Error(`${response.status} ${response.statusText}: ${body.message ?? "unknown"}`);
}
const { data, _meta } = await response.json();
```

For `429` and `5xx`, retry with exponential backoff. For `4xx` other than `429`, the request needs to change — retrying without modification won't succeed.

If a `403` is unexpected for data you should have access to, contact <a href="mailto:api@eliteprospects.com">[api@eliteprospects.com](mailto:api@eliteprospects.com)</a>.