# Error Codes Source: https://docs.scrappey.com/docs/guides/error-codes > Reference table of all Scrappey error codes, their error messages, and what to do when you encounter them. ## Example When a request fails, the response has `"data": "error"` and an `error` field containing the message. Handle the stable `CODE-XXXX` identifier in your code — it is the canonical key. The public `error` messages below are normalized categories; the raw, provider-specific diagnostics (including which verification provider was involved) are available in the debug view of your Scrappey dashboard. Many errors are transient — an automatic [retry](/docs/retry) or a different [proxy](/docs/premium-proxy) often resolves them. ```json { "solution": {}, "timeElapsed": 1234, "data": "error", "session": "your-session-id", "error": "Browser verification failed" } ``` ## Error Code Reference | **Code** | **Error Message** | **Description** | | ------------ | --------------------------------------------------------------------- | ------------------------------------------------------------------ | | `CODE-0001` | Server is overloaded | All server capacity is used, please try again. | | `CODE-0002` | Browser verification failed | Browser verification could not be completed, preventing access. | | `CODE-0003` | Too many verification attempts, try again | Too many attempts from your IP; try again later. | | `CODE-0004` | Invalid cmd command | The provided command is invalid. | | `CODE-0005` | Tunnel connection failed | Tunnel connection could not be established. | | `CODE-0006` | ERR\_HTTP\_RESPONSE\_CODE\_FAILURE | Failure in HTTP response. | | `CODE-0007` | Could not complete interactive verification | Clicking the verification widget failed. | | `CODE-0007` | Proxy error - ERR\_TUNNEL\_CONNECTION\_FAILED or ERR\_EMPTY\_RESPONSE | Proxy error. Review proxy configuration for the target site. | | `CODE-0008` | Target site rejected request | The target site rejected the request. | | `CODE-0009` | Error from ChatGPT, try again | ChatGPT API returned an error. | | `CODE-0010` | Proxy rejected by verification provider | Proxy rejected by the verification provider. Review proxy configuration and authorization for the target site. | | `CODE-0011` | Verification provider rejected session | A verification step could not be completed. | | `CODE-0012` | Could not parse verification cookie | Issue parsing a verification cookie. | | `CODE-0013` | Verification cookie processing error | A verification cookie could not be processed. | | `CODE-0014` | Could not load verification provider | The verification provider could not be loaded. | | `CODE-0015` | Socks4 With Authentication not Supported | Socks4 with authentication is not supported. | | `CODE-0016` | Socks5 With Authentication not Supported | Socks5 with authentication is not supported. | | `CODE-0017` | Browser verification temporarily unavailable, try again later | Temporary incompatibility with an updated verification release. | | `CODE-0018` | Too high error rate for this URL | Temporary ban due to high error rate. Contact support. | | `CODE-0019` | The proxy server is refusing connections | Check proxy settings. Proxy is refusing connections. | | `CODE-0020` | Could not find intercept request | System could not find the intercept request. | | `CODE-0021` | Unknown error occurred with request | An unknown request error occurred. | | `CODE-0022` | Captcha type solve\_captcha is not found | The specified captcha type was not found. | | `CODE-0023` | Interactive verification handler not found | The interactive verification handler was not found. | | `CODE-0024` | Proxy timeout - proxy too slow | Proxy took too long to respond. | | `CODE-0025` | NS\_ERROR\_NET\_TIMEOUT - proxy too slow | Browser-level timeout due to slow proxy. | | `CODE-0026` | Internal browser error | Internal browser failure. | | `CODE-0027` | No elements found for this CSS selector | The specified CSS selector did not match any elements. | | `CODE-0028` | Verification provider rejected session | A verification step could not be completed. | | `CODE-0029` | Too many sessions open | Maximum sessions exceeded. [Sessions](/docs/sessions-create) auto-expire after 240 seconds. | | `CODE-0030` | Browser name must be: firefox, chrome or safari | Only these browsers are supported. | | `CODE-0031` | Request error, please try again | General request error. Retry. | | `CODE-0032` | Interactive verification could not be completed | An interactive verification step could not be completed. Review proxy configuration and authorization for the target site. | | `CODE-0033` | Managed verification could not be completed | A managed verification step could not be completed. | | `CODE-0034` | Verification could not be completed after multiple attempts | Review proxy configuration and authorization for the target site. | | `CODE-0035` | Could not load verification widget | The verification widget failed to load. | | `CODE-0036` | Keyboard action value not found | The specified keyboard action is invalid. | | `CODE-0037` | Verification provider rejected session | The verification provider rejected the request. Review proxy configuration and authorization for the target site. | | `CODE-10000` | Unknown error - has to be specified | An unspecified error occurred. Needs review. | ## Related concepts Go deeper in the [Scrappey knowledge base](https://scrappey.com/qa): - [403 Forbidden](https://scrappey.com/qa/http-errors/what-is-a-403-error) — the classic "blocked by anti-bot" code - [429 Too Many Requests](https://scrappey.com/qa/http-errors/what-is-a-429-error) — rate-limit responses - [503 Service Unavailable](https://scrappey.com/qa/http-errors/what-is-a-503-error) — overload / challenge responses