# Errors

All errors return a JSON object with a short description.

```json
{
  "error": "not found"
}
```

| HTTP Code | When it happens                         | Example error              |
| --------- | --------------------------------------- | -------------------------- |
| 400       | Missing or invalid parameters           | `missing <NAME> parameter` |
| 401       | Unauthorized or missing/invalid API key | `unauthorized`             |
| 404       | Route not found                         | `not found`                |
| 500       | Unexpected server error                 | `internal server error`    |
| 503       | Service temporarily unavailable         | `service unavailable`      |

**Tip:** Use consistent error shapes across your API for predictable client handling.