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

# Errors

> Error codes returned by the Revex API.

Errors are returned as JSON with an `error` code.

```json theme={null}
{ "error": "INVALID_API_KEY" }
```

| Status | Code | What to do |
| - | - | - |
| 401 | `INVALID_API_KEY` | Check the `Authorization: Bearer rvx_...` header. The key may be wrong, revoked, or its creator may have left the team. |
| 429 | `RATE_LIMITED` | You hit a rate limit (30 requests per minute per key, or 20 failed key attempts per minute per IP). Wait and retry. |
| 503 | `PIN_EXHAUSTED` | No free PIN was available. Retry after a short delay. |

> [!TIP]
>
> Handle `429` and `503` with a retry and a short delay. Do not retry `401`, fix the key instead.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.