# Errors & recovery

Fix the cause before retrying.

## 400 / 422

invalid_filter, malformed_cursor, page_size_exceeded or validation_error: inspect the error envelope, correct the query and reduce page size where necessary. Preview rejects pagination and unsupported filters.

## 401 / 403

Check missing, invalid or revoked keys and account access status. Use account controls or support. Never put a key in a support request.

## 402 / 409

insufficient_balance: add prepaid credit, change the plan through existing account controls, or wait for the included reset. duplicate_request_id: use a fresh ID; Radar does not replay the old result.

## 404 / 429 / 503

opportunity_not_found: the canonical record is unavailable. rate_limit_exceeded or preview_rate_limit_exceeded: wait for Retry-After. metering_unavailable: wait and retry with a fresh request ID under a bounded retry policy. Preserve the safe request ID for support.