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

# Errors

> The error shape and what each status means.

Errors return a consistent JSON shape and the matching HTTP status code:

```json theme={null}
{
  "error": {
    "code": "NOT_FOUND",
    "message": "The requested content was not found (it may not exist, be deleted, or be private).",
    "requestId": "req_8f0c…"
  }
}
```

* **`code`** — a stable, machine-readable string (switch on this, not the message).
* **`message`** — a human-readable, safe description. It never leaks upstream or internal detail.
* **`requestId`** — quote it in support requests so we can trace the exact call.

## Status codes

| Status | `code`                                         | When                                                                               |
| ------ | ---------------------------------------------- | ---------------------------------------------------------------------------------- |
| `401`  | `UNAUTHORIZED`                                 | Missing, invalid, or revoked API key.                                              |
| `402`  | `INSUFFICIENT_CREDITS`                         | Balance is below the call's cost. Top up to continue.                              |
| `404`  | `NOT_FOUND`                                    | The target doesn't exist, is deleted, or is private.                               |
| `422`  | `VALIDATION_ERROR`                             | A required query param is missing or malformed (details included).                 |
| `429`  | `RATE_LIMITED`                                 | Over the per-minute limit. See [Rate limits](/essentials/rate-limits).             |
| `502`  | `UPSTREAM_BLOCKED` / `EXTRACTION_FAILED`       | The source was temporarily unavailable or returned unexpected data. Retry shortly. |
| `503`  | `SERVICE_UNAVAILABLE` / `PLATFORM_UNAVAILABLE` | Temporarily unavailable or at capacity. Honour `Retry-After`.                      |

<Tip>
  `422` responses include a `details` array pinpointing each invalid parameter, so you can surface precise
  validation feedback to your users.
</Tip>