Documentation menu

List of API Errors

This is the list of errors our API may produce. We strongly advise developers to log and analyze all API errors and take according actions on time, like fixing bugs in your app and distribute updates among your users. We are actively protecting our API from "nonsense" requests, which for example, produce the same error if same request is repeated over and over again. This includes IP and subnets bans as well as accounts suspensions in some severe cases.

Identifier Code Description
0 Code 0 is for "no errors".
1 ERROR_KEY_DOES_NOT_EXIST Account authorization key not found in the system. Make sure you copied it correctly without spaces and tabulation signs.
2 ERROR_NO_SLOT_AVAILABLE No idle captcha workers are available at the moment, customer need to increase their maximum bid in API settings inside client area or choose less busy hours to create tasks. More information about how bids are working can be found in FAQ.
3 ERROR_ZERO_CAPTCHA_FILESIZE The size of the captcha you are uploading is less than 100 bytes.
4 ERROR_TOO_BIG_CAPTCHA_FILESIZE The size of the captcha you are uploading is more than 500,000 bytes.
10 ERROR_ZERO_BALANCE Account has zero or negative balance.
11 ERROR_IP_NOT_ALLOWED Request with current account key is not allowed from your IP. Please refer to IP list section located in security settings inside client area.
12 ERROR_CAPTCHA_UNSOLVABLE Captcha could not be solved by 5 different workers. Customers are charged for such tasks as they spend time of our workers.
12 ERROR_BAD_DUPLICATES 100% recognition feature did not work due to lack of amount of guessing attempts.
14 ERROR_NO_SUCH_METHOD Request to API made with method which does not exist. Usually this happens when programmers mistype method names.
15 ERROR_IMAGE_TYPE_NOT_SUPPORTED Could not determine captcha file type by its exif header or image type is not supported. The only allowed formats are JPG, GIF, PNG. Images must contain EXIF header which holds information about image type.
16 ERROR_NO_SUCH_CAPCHA_ID Captcha you are requesting does not exist in your active captchas list or has been expired.
Captchas are removed from API after 60 seconds after task completion by a worker. During this period your app should send all task result polls and correct/incorrect reporting request.
21 ERROR_IP_BLOCKED Your IP is blocked due to improper use of API. Check the reason here.
22 ERROR_TASK_ABSENT "task" property is empty or not set in createTask method.
23 ERROR_TASK_NOT_SUPPORTED Task type is not supported or typed incorrectly. Please check "type" property in task object.
24 ERROR_INCORRECT_SESSION_DATA Some of the required values for successive user emulation are missing. API output contains more details what is missing.
25 ERROR_PROXY_CONNECT_REFUSED Could not connect to task's proxy, connection refused.
Learn more about working with proxy in this FAQ section.
26 ERROR_PROXY_CONNECT_TIMEOUT Could not connect to task's proxy, connection timeout.
Learn more about working with proxy in this FAQ section.
27 ERROR_PROXY_READ_TIMEOUT Reading timeout of task's proxy
Learn more about working with proxy in this FAQ section.
28 ERROR_PROXY_BANNED Proxy IP is banned by target service.
29 ERROR_PROXY_TRANSPARENT Task denied at proxy checking state. Proxy must be non-transparent to hide our server IP. Use our proxy checker tool to debug your proxy.
30 ERROR_RECAPTCHA_TIMEOUT Recaptcha task timeout, probably due to slow proxy server or Google server
31 ERROR_RECAPTCHA_INVALID_SITEKEY Captcha provider reported that site key is invalid.
32 ERROR_RECAPTCHA_INVALID_DOMAIN Captcha provider reported that domain for this site key is invalid.
33 ERROR_RECAPTCHA_OLD_BROWSER Captcha provider reported that browser user-agent is not compatible with their javascript
34 ERROR_TOKEN_EXPIRED Captcha provider server reported that additional variable token has been expired. Please try again with new token.
35 ERROR_PROXY_HAS_NO_IMAGE_SUPPORT Proxy does not support transfer of image data from Google servers. Use our proxy checker tool to debug your proxy.
36 ERROR_PROXY_INCOMPATIBLE_HTTP_VERSION Proxy does not support long GET requests with length about 2000 bytes and does not support SSL connections. Use our proxy checker tool to debug your proxy.
49 ERROR_PROXY_NOT_AUTHORISED Proxy login and password are incorrect. Use our proxy checker tool to debug your proxy.
51 ERROR_INVISIBLE_RECAPTCHA Invisible Recaptcha was attempted to be solved as usual one.
52 ERROR_FAILED_LOADING_WIDGET Could not load captcha provider widget in worker browser. Please try sending a new task.
53 ERROR_VISIBLE_RECAPTCHA Usual Recaptcha V2 was attempted to solved as Recaptcha V2 invisible. Remove flag 'isInvisible' from API payload.
54 ERROR_ALL_WORKERS_FILTERED
No workers left which were not filtered by reportIncorrectRecaptcha method.
55 ERROR_ACCOUNT_SUSPENDED System suspended your account for a significant reason. Contact support for details.