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

# Errors

Malomo uses conventional HTTP response codes to indicate success or failure of an API request. In general: Codes in the `2xx` range indicate success. Codes in the `4xx` range indicates that a request failed with the information provided. Codes in the `5xx` range indicate an error with Malomo's servers.

| HTTP STATUS CODE                   |                                           |
| ---------------------------------- | ----------------------------------------- |
| 200 - OK                           | Everything worked as expected             |
| 400 - Bad Request                  | The request couldn't be completed         |
| 401 - Unauthorized                 | No valid API key was provided             |
| 404 - Not Found                    | The requested resource could not be found |
| 500, 502, 503, 504 - Server Errors | We screwed up. Sorry!                     |

#### `400`, `401`, `404` and `5xx` Response Format

| ATTRIBUTE    |                                                                 |
| ------------ | --------------------------------------------------------------- |
| `code`       | The type of error returned                                      |
| `message`    | A human-readable message providing more details about the error |
| `request_id` | Unique identifier for a specific request                        |
| `status`     | HTTP status code                                                |