# 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.