Errors
Search CompSniper error codes, retry behavior, request identifiers, and recovery guidance.
Every error body contains a human-readable error and stable machine-readable code.
| HTTP | Code | Meaning | Correct action |
|---|---|---|---|
| 400 | invalid_params | Missing or malformed parameter | Correct the request; do not retry unchanged |
| 401 | unauthorized | Missing, malformed, or revoked API key | Supply a valid bearer key |
| 403 | unauthorized | OAuth credential lacks the required scope | Reconnect with the required scope |
| 404 | not_found | Job missing, expired, or owned by another account | Check jobId and credential |
| 409 | conflict | Another Max Mode or Card Batch job is active | Poll or cancel the active job |
| 429 | rate_limited | Per-minute limit exceeded | Wait for Retry-After, then retry with a bound |
| 429 | quota_exceeded | Monthly quota exhausted | Never loop; upgrade or wait for reset |
| 500 | server_error | Unexpected CompSniper failure | Retry with backoff, then contact support |
| 502 | upstream_blocked | eBay refused the upstream fetch | Retry with bounded backoff |
| 503 | server_busy | Service temporarily at capacity | Respect Retry-After and reduce concurrency |
Request identifiers
When contacting [email protected], include:
- HTTP status
- Response
code X-Request-IDheader- Endpoint and approximate timestamp
Never send your complete API key.
Retry decision
Retry only rate_limited, temporary server_error, upstream_blocked, and server_busy responses.
Never retry invalid parameters, authentication failures, missing jobs, conflicts, or monthly quota
exhaustion without first changing the relevant state.