API Error Catalog
Last updated: 2026-06-20 01:22:53 UTC
Back to Developers System Status Trust Center
This error catalog is part of the public project trust stack. It gives partners a stable remediation reference they can compare against the same live API, status, and reliability surfaces used across the VETS Coin platform.
The JSON surface now includes keyed `by_code` lookups and additive `recovery_links` so partner tooling can route responders directly to the right trust, status, and recovery pages.
Source: /home/vets-coin/flask_api/config/api_error_catalog.json | Updated: 2026-03-10T22:15:00Z
| Error Code | HTTP | Remediation | Retry |
|---|---|---|---|
| unauthorized | 401 |
Check signing key id, signature, and timestamp skew.
Verify nonce uniqueness to avoid replay rejections.
Confirm requested endpoint scope matches key permissions.
|
Do not blindly retry. Fix credentials/signature first.
|
| rate_limited | 429 |
Respect Retry-After and exponential backoff.
Reduce burst concurrency and reuse idempotency keys for retries.
Request higher quota only after proving sustained usage patterns.
|
Retry with exponential backoff (1s, 2s, 4s...) and jitter.
Retry-After: 60s
|
| rpc_unavailable | 503 |
Retry after cooldown window.
Inspect /api/public/rpc-circuit-breaker for open/closed state.
Validate upstream provider health before raising incident severity.
|
Retry after cooldown using capped exponential backoff.
Retry-After: 120s
|