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 |
| 402 | payment_required | The subscription's last renewal payment failed, so the account is on hold | Do not retry; pay the open invoice or update the card at billingUrl. Access resumes as soon as the payment succeeds |
| 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 |
| 409 | idempotency_conflict | Shipping idempotency key was reused with another body | Use a new key for the new operation |
| 409 | idempotency_in_progress | Identical shipping request is still running | Wait briefly and retry the same key and body |
| 422 | no_shipping_rates | No service was available for the route and package | Review the input; no shipping request is charged |
| 429 | rate_limited | Per-minute limit exceeded | Wait for Retry-After, then retry with a bound |
| 429 | history_rate_limited | Per-minute cap for /v1/research/sold exceeded | Wait for Retry-After, then retry with a bound |
| 429 | quota_exceeded | Selected monthly quota and credit balance exhausted | Never loop; buy credits, upgrade, or wait for reset |
| 429 | shipping_quota_exceeded | Separate Shipping Rates allowance exhausted | Upgrade Shipping Rates 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 |
| 502, 503 | historical_unavailable | eBay sold history source did not answer this time | Retry after a few seconds with a bound; not charged |
Shipping upstream failures use upstream_unavailable and do not consume shipping quota.
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 purchasing credits, upgrading, or reaching the monthly reset.