> For the complete documentation index, see [llms.txt](https://docs.betaramps.com/documentation-beta-ramps/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.betaramps.com/documentation-beta-ramps/api-guide/errors.md).

# Errors

When your API request cannot be completed successfully, the response provides information about the failure in the message body and the HTTP status code.

For validation errors, Beta provides details of what failed, including the field that failed validation and the problem with it.

Some of the status codes we return are listed below.

| Code | Title                 | Description                                                                                                       |
| ---- | --------------------- | ----------------------------------------------------------------------------------------------------------------- |
| 400  | Bad Request           | The server cannot process the request because it is inadequately formed.                                          |
| 401  | Unauthorised          | The API key is invalid.                                                                                           |
| 403  | Forbidden             | The API key doesn't have appropriate permissions for the request.                                                 |
| 404  | Not Found             | You requested an object or page that could not be found.                                                          |
| 429  | Too Many Requests     | The rate limit was exceeded i.e. the server received too many requests in a given period of time.                 |
| 500  | Internal Server Error | The server encountered an error. Try again later.                                                                 |
| 503  | Service Unavailable   | The server is unable to handle the request due to a temporary overload or scheduled maintenance. Try again later. |