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

# Errors

> How the Unblocked API formats error responses and what each status code means

When a request to the Unblocked API fails, the response body is a JSON object with a `status` field containing the HTTP status code.

```json theme={null}
{
  "status": 401
}
```

## Status codes

| Status | Description                                                                                     |
| ------ | ----------------------------------------------------------------------------------------------- |
| 400    | Bad request. The request body or parameters are invalid.                                        |
| 401    | Unauthorized. The request is missing a valid API token, or the token is invalid or expired.     |
| 403    | Forbidden. The API token doesn't have permission to perform this action.                        |
| 404    | Not found. The requested resource doesn't exist, or you don't have access to it.                |
| 429    | Too many requests. You've exceeded a rate limit. See [Rate limits](/api-reference/rate-limits). |
| 500    | Internal server error. An unexpected error occurred on the server.                              |
| 502    | Bad gateway. The API couldn't connect to an upstream service.                                   |
| 504    | Gateway timeout. An upstream service didn't respond in time.                                    |

## Retrying failed requests

502 and 504 responses are transient. Retry the request with a short delay between attempts.

A 500 response may also be transient, but retrying isn't guaranteed to succeed. If it persists, [contact us](https://getunblocked.com/dashboard?showIntercom=true).

For 429 responses, wait before retrying. See [Rate limits](/api-reference/rate-limits) for current limits.