API Error Codes
When a request fails, the API returns an error code instead of a task ID or an answer. The tables below are grouped by API format, so look in the section that matches the format your software uses: RuCaptcha (2Captcha) or Anti-Captcha.
The code you will see most often is CAPCHA_NOT_READY. It is not really an error: the captcha is still being solved. Wait about 10 seconds and send the same request again. If you keep getting ERROR_ZERO_BALANCE, top up your balance in the dashboard; you can also check the balance through the API.
Rucaptcha
Errors http://api2.cap.guru/in.php for image captchas
| Errors | Description |
|---|---|
| ERROR_WRONG_USER_KEY | Invalid API key |
| ERROR_ZERO_BALANCE | Balance 0 or negative, top up your account in your personal account |
| ERROR_TOO_BIG_CAPTCHA_FILESIZE | The image has too much weight |
| ERROR_UPLOAD | Failed to load |
| ERROR_CAPTCHA_UNSOLVABLE | The service could not solve your captcha |
Errors http://api2.cap.guru/in.php for ReCaptchaV2&Invisible and ReCaptchaV3
| Errors | Description |
|---|---|
| ERROR_WRONG_USER_KEY | Invalid API key |
| ERROR_ZERO_BALANCE | Balance 0 or negative, top up your account in your personal account |
| ERROR_NO_SLOT_AVAILABLE | There are no free slots, you have sent too many tasks or the service is loaded |
| ERROR_PAGEURL | Invalid site link |
| ERROR_GOOGLEKEY | Incorrect google key |
| ERROR_CAPTCHA_UNSOLVABLE | The service could not solve your captcha |
Errors http://api2.cap.guru/res.php
| Errors | Description |
|---|---|
| ERROR_WRONG_USER_KEY | Invalid API key |
| ERROR_ZERO_BALANCE | Balance 0 or negative, top up your account in your personal account |
| ERROR_GOOGLEKEY | Incorrect google key |
| ERROR_CAPTCHA_UNSOLVABLE | The service could not solve your captcha |
| CAPCHA_NOT_READY | The solution is not ready yet, the task is in the process of being solved, send your request in 10 seconds |
| ERROR_NO_SUCH_CAPCHA_ID | Task ID not found. |
| ERROR_WRONG_CAPTCHA_ID | Task ID not found. |
| notpic | The object in the image was not found. |
Anti-captcha
Errors http://api2.cap.guru/createTask for pictures
| Errors | Description |
|---|---|
| ERROR_KEY_DOES_NOT_EXIST | Invalid API key |
| ERROR_ZERO_BALANCE | Balance 0 or negative, top up your account in your personal account |
| ERROR_TOO_BIG_CAPTCHA_FILESIZE | The image has too much weight |
| ERROR_UPLOAD | Failed to load |
| ERROR_IMAGE_TYPE_NOT_SUPPORTED | The service could not solve your captcha |
Errors http://api2.cap.guru/createTask for ReCaptchaV2&Invisible and ReCaptchaV3
| Errors | Description |
|---|---|
| ERROR_WRONG_USER_KEY | Invalid API key |
| ERROR_ZERO_BALANCE | Balance 0 or negative, top up your account in your personal account |
| ERROR_NO_SLOT_AVAILABLE | There are no free slots, you have sent too many tasks or the service is loaded |
| ERROR_RECAPTCHA_INVALID_DOMAIN | Invalid site link |
| ERROR_RECAPTCHA_INVALID_SITEKEY | Invalid google key |
| ERROR_CAPTCHA_UNSOLVABLE | The service could not solve your captcha |
| Errors | Description |
|---|---|
| ERROR_KEY_DOES_NOT_EXIST | Invalid API key |
| ERROR_ZERO_BALANCE | Balance 0 or negative, top up your account in your personal account |
| ERROR_GOOGLEKEY | Incorrect google key |
| ERROR_CAPTCHA_UNSOLVABLE | The service could not solve your captcha |
| CAPCHA_NOT_READY | The solution is not ready yet, the task is in the process of being solved, send your request in 10 seconds |
| ERROR_NO_SUCH_CAPCHA_ID | Task ID not found. |
| ERROR_WRONG_CAPTCHA_ID | Task ID not found. |
| notpic | The object in the image was not found. |
Errors http://api2.cap.guru/in.php for Hcaptcha
| Errors | Description |
|---|---|
| ERROR_WRONG_USER_KEY | Invalid API key |
| ERROR_ZERO_BALANCE | Balance 0 or negative, top up your account in your personal account |
| ERROR_NO_SLOT_AVAILABLE | There are no free slots, you have sent too many tasks or the service is loaded |
| ERROR_PAGEURL | Invalid site link |
| ERROR_HKEY | Invalid hcaptcha key |
| ERROR_CAPTCHA_UNSOLVABLE | The service could not solve your captcha |
Errors http://api2.cap.guru/res.php for Hcaptcha
| Errors | Description |
|---|---|
| ERROR_WRONG_USER_KEY | Invalid API key |
| ERROR_ZERO_BALANCE | Balance 0 or negative, top up your account in your personal account |
| ERROR_CAPTCHA_UNSOLVABLE | The service could not solve your captcha |
| CAPCHA_NOT_READY | The solution is not ready yet, the task is in the process of being solved, send your request in 10 seconds |
| ERROR_WRONG_CAPTCHA_ID | Task ID not found. |
| notpic | The object in the image was not found. |
Errors http://api2.cap.guru/in.php for Geetest
| Errors | Description |
|---|---|
| ERROR_WRONG_USER_KEY | Invalid API key |
| ERROR_ZERO_BALANCE | Balance 0 or negative, top up your account in your personal account |
| ERROR_NO_SLOT_AVAILABLE | There are no free slots, you have sent too many tasks or the service is loaded |
| ERROR_PAGEURL | Invalid site link |
| ERROR_CAPTCHA_UNSOLVABLE | The service could not solve your captcha |
| ERROR_GEETTEST_GT | Empty GT value |
| ERROR_GEETTEST_challenge | Empty challenge value |
Errors http://api2.cap.guru/res.php for Geetest
| Errors | Description |
|---|---|
| ERROR_WRONG_USER_KEY | Invalid API key |
| ERROR_ZERO_BALANCE | Balance 0 or negative, top up your account in your personal account |
| ERROR_CAPTCHA_UNSOLVABLE | The service could not solve your captcha |
| CAPCHA_NOT_READY | The solution is not ready yet, the task is in the process of being solved, send your request in 10 seconds |
| ERROR_WRONG_CAPTCHA_ID | Task ID not found. |
| ERROR_CAPTCHA_BAD_GT_OR_CNANNEL | Invalid GT or CNANNEL |
| ERROR_PROXY_CONNECTION_FAILED | Proxy is not working. |