Every error string ParlayAPI returns, what HTTP status accompanies it, what it means, and what to do. Filterable. If you got an error code that isn't in this list, paste the request_id header in r/parlayapi or email support@parlay-api.com and we'll add it within the day.
| Status | Code | Meaning + what to do |
|---|
| Header | Meaning |
|---|---|
X-Request-ID | Per-request 32-hex trace ID. Include this when reporting an issue. |
X-Response-Time | Server processing time in milliseconds. |
X-RateLimit-Remaining | Credits remaining in the current period. Drops to 0 just before OUT_OF_USAGE_CREDITS. |
Retry-After | Seconds to wait before retrying. Present on 429 and on 503 responses from the failover thin-tier. |
GET /healthz — gateway liveness.GET /v1/status — per-source freshness, SLA classification, poller circuit-breaker state.GET /v1/meta/source-quality — per-source SLA + recommended cadence.