NeuroCaptcha

Errors

Every error code of the API: errorId, errorCode, what it means and what to do.

এই বিভাগটি ইংরেজিতে দেখানো হয়েছে।

Every answer is HTTP 200 with errorId. 0 means success; otherwise there are errorCode and a human-readable errorDescription:

Error
{
  "errorId": 1,
  "errorCode": "ERROR_KEY_DOES_NOT_EXIST",
  "errorDescription": "Account authorization key not found in the system."
}
  • Check errorId != 0, not the HTTP status.
  • Branch on errorCode; errorDescription is for people and may change.
  • Ids 1–55 follow the Anti-Captcha registry, ids from 90 are codes of this service. An unknown failure is ERROR_INTERNAL (90) — never errorId: 0.
  • A failed task is not charged. 2Captcha names of the codes: 2Captcha compatibility.

All codes#

1

ERROR_KEY_DOES_NOT_EXIST

অর্থ
clientKey is missing, malformed, revoked or unknown.
কী করবেন
Copy the key again from Dashboard → API keys; check for spaces and line breaks and that it is not a key of another service.
2

ERROR_NO_SLOT_AVAILABLE

অর্থ
The key already has the maximum number of tasks in progress (200 by default).
কী করবেন
Wait until some tasks finish and retry in 1–2 seconds, or raise the parallel limit of the key in the dashboard.
10

ERROR_ZERO_BALANCE

অর্থ
The available balance is below the price of the task. Money held for tasks in progress is not available.
কী করবেন
Top up the balance. Test keys do not need a balance.
11

ERROR_IP_NOT_ALLOWED

অর্থ
The request came from an IP address that is not in the key's allowlist.
কী করবেন
Add the address or network to the allowlist of the key, or clear the list.
12

ERROR_CAPTCHA_UNSOLVABLE

অর্থ
The task could not be solved after all attempts. The held money is returned — the task is free.
কী করবেন
Create a new task. If it repeats, check websiteURL, websiteKey, isInvisible / pageAction and the proxy.
14

ERROR_NO_SUCH_METHOD

অর্থ
Unknown method, wrong HTTP method, or the body is not valid JSON (for example, taskId sent as a string).
কী করবেন
Send POST with a JSON body to a documented method.
16

ERROR_NO_SUCH_CAPCHA_ID

অর্থ
No task with this id in your account, or its result expired (10 minutes after it was solved). Reports about unsolved tasks also get this code.
কী করবেন
Check taskId and the key — tasks are visible to the account that created them. Fetch results soon after they are ready, or use webhooks.
21

ERROR_IP_BLOCKED

অর্থ
Requests from this IP address are blocked because of abuse.
কী করবেন
Write to support with your account email and the IP address.
22

ERROR_TASK_ABSENT

অর্থ
task is missing or invalid: a required field is empty, a value is out of range, callbackUrl is not a public http(s) URL, or the body is larger than 1 MiB. errorDescription names the field.
কী করবেন
Fix the field named in errorDescription and send the task again.
23

ERROR_TASK_NOT_SUPPORTED

অর্থ
Unknown or disabled task type.
কী করবেন
Take the type from getTaskTypes. Names are case-sensitive: RecaptchaV2TaskProxyless, not ReCaptchaV2TaskProxyLess.
25

ERROR_PROXY_CONNECT_REFUSED

অর্থ
The proxy refused the connection.
কী করবেন
Check the address, port and type of the proxy, and that it accepts connections from the internet.
26

ERROR_PROXY_CONNECT_TIMEOUT

অর্থ
Connecting to the proxy timed out.
কী করবেন
Check that the proxy is online; use a faster one.
27

ERROR_PROXY_READ_TIMEOUT

অর্থ
The proxy accepted the connection but did not answer in time.
কী করবেন
Use a more stable proxy.
28

ERROR_PROXY_BANNED

অর্থ
The proxy IP is blocked by Google or by the site.
কী করবেন
Use another proxy, preferably residential or mobile.
30

ERROR_RECAPTCHA_TIMEOUT

অর্থ
The task was not solved in time: no worker took it within 180 seconds, or the attempts ran out. Not charged.
কী করবেন
Create a new task. If it keeps happening, check the status page and your proxy.
31

ERROR_RECAPTCHA_INVALID_SITEKEY

অর্থ
Google rejected the site key.
কী করবেন
Take websiteKey from the page again (data-sitekey or the k parameter); do not mix v2, v3 and Enterprise keys.
32

ERROR_RECAPTCHA_INVALID_DOMAIN

অর্থ
The site key is not valid for the domain of websiteURL.
কী করবেন
Pass the address of the page where the widget is really shown.
33

ERROR_RECAPTCHA_OLD_BROWSER

অর্থ
The site considers the browser outdated.
কী করবেন
Pass a current desktop userAgent.
35

ERROR_PROXY_HAS_NO_IMAGE_SUPPORT

অর্থ
The proxy does not load images (a compatibility code).
কী করবেন
Use another proxy.
49

ERROR_PROXY_NOT_AUTHORISED

অর্থ
Wrong proxy login or password.
কী করবেন
Check proxyLogin and proxyPassword.
53

ERROR_VISIBLE_RECAPTCHA

অর্থ
The widget type does not match isInvisible: an invisible reCAPTCHA sent as visible or the other way round.
কী করবেন
Set isInvisible according to the widget on the page.
55

ERROR_ACCOUNT_SUSPENDED

অর্থ
The account is suspended.
কী করবেন
Write to support.
90

ERROR_INTERNAL

অর্থ
A temporary failure on our side. Any unknown error is reported with this id too — never with errorId: 0.
কী করবেন
Retry with a growing pause (1, 2, 4… seconds). If it lasts, check the status page.
91

ERROR_TOO_MUCH_REQUESTS

অর্থ
Rate limit: more than 30 createTask or 50 getTaskResult per second for the key, or more than 100 requests per second from one IP.
কী করবেন
Slow down and retry with a pause; poll each task every 2–3 seconds.
92

ERROR_SPENDING_LIMIT

অর্থ
The daily or monthly spending cap of the key is reached.
কী করবেন
Raise or remove the cap in the key settings, or wait for the next day or month.