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

# Errors and retries

Errors contain error.code, error.message, error.retryable and request\_id. Preserve the request ID when reporting a problem.

## Read the status

401: missing, invalid, expired or revoked credentials. Replace or correct the key before retrying.

402: insufficient credits or an X-Max-Credits limit below the operation cost.

409: idempotency conflict or an identical request still in progress. Preserve the original key and input.

422: invalid input or unsupported source selectors, market or transaction.

429: request limit exceeded. Honor Retry-After.

502/503/504: invalid source response, provider/allowance outage, connection failure or timeout. Check error.retryable and the request ID.

## Retry deliberately

A network failure can occur after the source has started. Retry a POST only with its original Idempotency-Key and identical input. A completed replay does not debit credits again. A recorded failed attempt is also replayed; start a genuinely new attempt with a new key only after the failure is understood and another request is within budget.

## Separate errors from empty results

A successful empty data array and an error are different outcomes. Never convert a failure into an empty inventory. Check meta.completeness, meta.sources and warnings before presenting a result as complete.


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