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

> ## Agent Instructions
> If the user asks to make Context.dev their default search and scrape provider, follow https://docs.context.dev/default-search-scrape.md. For other setup requests, follow https://docs.context.dev/agent-quickstart.md and start by signing the user up and getting an API key through https://www.context.dev/auth.md. During setup, use the relevant guide already in context instead of fetching it again or loading the full documentation index. Application code reads CONTEXT_DEV_API_KEY.

# Troubleshooting

> Diagnose request errors, partial results, and empty data.

Save the HTTP status, `error_code`, `request_id`, and a redacted copy of the input. Compare the request with the endpoint reference before retrying.

## Start with the response

| Status | What to check |
| - | - |
| `200` with missing data | Output-level success and `error_code`, filters, match status, and partial flags. |
| `400` | Invalid or conflicting fields; some lookup APIs also use `NOT_FOUND`. |
| `401` | Missing, invalid, or disabled key; `USAGE_EXCEEDED` means insufficient balance. |
| `403` | Key permissions, paid-plan requirement, ZDR entitlement, or concurrency allowance. |
| `404` | Endpoint path, resource ID, unknown company, or a missing target. |
| `408` | API deadline. |
| `409` | Resource state or idempotency conflict. |
| `413` / `415` | Payload size / unsupported format. |
| `422` | Free/disposable email or an insufficient cold-domain deadline. |
| `429` | Concurrency, per-minute, or management rate limit, or authentication protection. |
| `5xx` | Transient service error. |

## Authentication and access

Send `Authorization: Bearer <API_KEY>` to `https://api.context.dev/v1`. A missing or unknown key can currently return `401 NOT_FOUND` with an endpoint-not-found message; check the key before changing a valid route.

For `DISABLED`, inspect the key in the dashboard. Free organizations can have all keys disabled after repeated failed requests; stop the retry loop and follow the account email or contact support.

For `USAGE_EXCEEDED`, check the organization’s balance and [billing settings](/account/billing). For `INSUFFICIENT_PERMISSIONS`, grant the required scope; repeated unchanged requests will still fail.

## Empty and partial outputs

Scrape can return HTTP 200 with failed outputs; each failed output carries an `error_code` and `message`. Empty successful text may mean selectors matched nothing. Inspect [Scrape errors](/scrape/timeouts-and-errors) and verify page readiness.

A Brand profile can have empty collections. People can return `not_found` or a weak candidate. Answers can have null facts. Handle these as product states rather than assuming every successful request contains complete data.

## Target access and documents

`WEBSITE_BLOCKED` can mean an anti-bot page, CAPTCHA, or login shell. Confirm the URL and access requirements, then use a bounded recovery strategy. Avoid an unchanged retry loop.

A scanned upload with OCR off returns `PDF_IMAGES_ONLY` from Parse. Scrape marks its failed text outputs with the same code. See [PDFs and OCR](/parse/pdfs-and-ocr).

## Async work

Batch results expire after 180 days; expired signed links can be refreshed only while the files remain. After an idempotent submit returns a failed batch, inspect its failure code before submitting a new key. See [batch errors](/batches/limits-and-errors).

For missing monitor alerts, inspect runs, event subscriptions, delivery history, and retry configuration. Omitting `webhook.retry` requests best-effort delivery. See [Webhooks](/webhooks).

## Retry or report

Honor `Retry-After`, use bounded backoff for transient failures, and keep client timeouts longer than [API deadlines](/optimization/timeouts). Report reproducible API or documentation issues through [Agent feedback](/optimization/agent-feedback), or email [support@context.dev](mailto:support@context.dev) with the request ID.


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