Error Reference
Standard HTTP status codes with consistent JSON error bodies.
Error Format
Errors are returned as JSON with a consistent shape:
{"success": false, "error": "description"}Status Codes
| Status | Meaning |
|---|---|
400 | Malformed request body, missing url field, or invalid URL format. |
401 | Missing or invalid X-API-Key header. |
402 | Insufficient credits. Visit your dashboard to redeem or purchase more. |
403 | Blocked. Usually CSRF failure on web forms or private-IP target. |
429 | Rate limit exceeded. Check the Retry-After header. |
500 | Internal solver error. Logged, and you are NOT charged. |
502 | Upstream target unreachable through all proxies. NOT charged. |
504 | Solve timed out. NOT charged. |