Documentation menu
Errors and limits
Stable error codes, retry behavior and usage policies.
All public errors use status: false, a stable code, a safe message and optional field-level details.
Core error codes
| HTTP | Code | Behavior |
|---|---|---|
| 400 | validation_error | Correct the request fields. |
| 401 | missing_api_key, invalid_api_key | Correct key delivery or key state. |
| 403 | access_restricted, source_scope | Review domain, IP or source permissions. |
| 429 | page_size_limit, daily_limit, monthly_limit, rate_limit_exceeded | Reduce traffic according to the limit. |
| 503 | service_unavailable | Apply short exponential backoff. |
| 500 | internal_error | Contact support after a bounded retry. |
Retry policy
Do not retry 400, 401 or 403 until the request or permission is fixed. Respect reset behavior for 429. Use bounded exponential backoff with jitter for 503. Never retry indefinitely.
Effective limit
The stricter API key or institution policy wins. Requests outside allowedSources are rejected and pageSize cannot exceed policy.
Decision boundary
An API result is a candidate match. A final sanctions or compliance decision requires official-source verification and human review.