Error descriptions
Before submitting a task:
- make sure the CAPTCHA type you need is supported by CapMonster Cloud. If the required CAPTCHA type is not currently supported, let us know — we will consider adding support for it;
- use up-to-date API parameters;
- when using a proxy, make sure it is available and stable.
If the error persists, contact support via the form, the chat on our website or in the documentation, or via the Telegram channel.
When contacting support, provide taskId, the task type (type), the original input data or image, the task date and time, and, if possible, the request body.
Some errors are temporary. In such cases, you can retry the request after some time or create a new task — the recommended action is specified in the corresponding error description.
If the error is related to the API key, balance, task parameters, proxy, token, or other input data, check and correct the corresponding values before retrying the request.
When retrying requests, follow the recommended intervals and increase the delay between attempts if necessary.
INVALID KEY
API error code: ERROR_KEY_DOES_NOT_EXIST
API key not found or provided in an incorrect format. Make sure you are using the key from your personal dashboard and that it is active. If the error persists, contact support providing taskId and the full request.
INVALID CHARACTER
API error code: ERROR_PROXY_CREDENTIALS_INVALID_CHARACTER
Login or password of the proxy contains an invalid character %. Specify the proxy credentials without this character and retry the request.
NO FUNDS
API error code: ERROR_ZERO_BALANCE
Insufficient funds on the account to solve captchas. Top up your balance and retry the task.
BIG IMAGE SIZE
API error code: ERROR_TOO_BIG_CAPTCHA_FILESIZE
The uploaded image exceeds the maximum allowed size of 50 KB. Reduce the resolution or compress the file, then resubmit the task. This error occurs only for captchas with image uploads (ImageToText, ComplexImageTask, ComplexImageTask Recaptcha, etc.).
ZERO IMAGE SIZE
API error code: ERROR_ZERO_CAPTCHA_FILESIZE
The image size is too small (less than 100 bytes). Check that the file is valid and contains the captcha image.
CAPTCHA ID IS NOT FOUND
API error code: ERROR_NO_SUCH_CAPCHA_ID, WRONG_CAPTCHA_ID
Check the taskId value. The error may occur if the task does not exist, the result storage period has expired, or the identifier has an invalid format. Retrying the request with the same taskId will not return a result.
CAPTCHA UNSOLVABLE
API error code: ERROR_CAPTCHA_UNSOLVABLE
The CAPTCHA could not be solved. This is usually a temporary error — try creating the task again. Also check that the request parameters are correct and up to date.
For image-based CAPTCHAs, repeated errors may indicate that the image cannot be recognized correctly: it may contain too much noise, be corrupted, or not contain an answer.
Unsolved tasks are not charged.
CAPTCHA IS NOT READY
API error code: CAPTCHA_NOT_READY
The task is still being solved. Retry the getTaskResult request later, keeping an interval of at least 2 seconds between requests.
REQUEST IS NOT ALLOWED FROM YOUR IP
API error code: ERROR_IP_NOT_ALLOWED
Request from this IP address with the current key is denied. Open the settings section in your personal dashboard and add your IP to the trusted list.
IP BANNED
API error code: ERROR_IP_BANNED
The IP address has been temporarily blocked due to a large number of invalid requests. Check that the requests are correct and try again later. Do not retry immediately after receiving this error.
INCORRECT METHOD
API error code: ERROR_NO_SUCH_METHOD
An incorrect task type (parameter type) is specified. Check the list of supported captcha types (parameter type value).
REQUEST LIMIT EXCEEDED
API error code: ERROR_TOO_MUCH_REQUESTS
The allowed request limit has been exceeded. Increase the interval between repeated requests and try again. When requesting a task result, call getTaskResult no more often than once every 2 seconds.
THE DOMAIN IS NOT ALLOWED
API error code: ERROR_DOMAIN_NOT_ALLOWED
Solving captchas from certain domains is forbidden in CapMonster Cloud. When trying to create a task for such domains, you will receive this error.
THE TOKEN IS EXPIRED
API error code: ERROR_TOKEN_EXPIRED
The provided token or challenge has expired. Obtain a current value and create a new task. Resubmitting the task with the same data will result in the same error.
INVALID RECAPTCHA SITEKEY
API error code: ERROR_RECAPTCHA_INVALID_SITEKEY
An invalid websiteKey was provided. Check the value in the captcha page source and provide it correctly. If you have difficulty finding the correct key, please contact support.
INVALID RECAPTCHA DOMAIN
API error code: ERROR_RECAPTCHA_INVALID_DOMAIN
The domain does not match the specified sitekey, or the websiteURL parameter is in an incorrect format. Provide the full URL of the page with the captcha, including the protocol. Only http:// and https:// are supported.
RECAPTCHA TIMEOUT
API error code: ERROR_RECAPTCHA_TIMEOUT
The CAPTCHA solving time has expired. Create a new task. If the error occurs repeatedly when using your own proxy, check its speed and availability or use a different proxy.
YOUR IP IS BLOCKED
API error code: ERROR_IP_BLOCKED
Access from this IP is blocked due to a high number of failed requests. Check task parameters and API key before resubmitting.
FAILED TO CONNECT PROXY
API error code: ERROR_PROXY_CONNECT_REFUSED
The proxy server refused the connection. Check the IP address, port, and proxy availability, or use a different proxy.
THE PROXY IP IS BANNED
API error code: ERROR_PROXY_BANNED
The specified proxy is blocked by the target website. Use a different proxy.
MISSING PROXY
API error code: ERROR_PROXY_MISSING
Proxy parameters are missing in required fields or an incorrect proxyType is specified. Provide all required parameters: proxyType, proxyAddress, proxyPort. Verify the correctness of proxyType.
PROXY NOT AUTHORIZED
API error code: ERROR_PROXY_NOT_AUTHORISED
Incorrect proxy authorization data: proxyLogin or proxyPassword. Check proxyLogin and proxyPassword. Ensure the authorization data is correct and active.
PROXY READ TIMEOUT
API error code: ERROR_PROXY_READ_TIMEOUT
The response timed out while using the proxy. Retry the request. If the error occurs regularly, check the proxy availability and stability or use a different proxy.
INCORRECT TASK TYPE
API error code: ERROR_TASK_NOT_SUPPORTED
The specified task type is unsupported or invalid. Please check the value of the type property in the task object.
TASK ABSENT
API error code: ERROR_TASK_ABSENT
The task object is missing in the createTask request or the JSON is invalid. Check the request structure.
USERAGENT IS EXPIRED
API error code: ERROR_WRONG_USERAGENT
An invalid User Agent was provided in the request. You can find the current User Agent here.
SERVICE NOT AVAILABLE
API error code: ERROR_SERVICE_NOT_AVAILABLE
The service is temporarily unavailable. This error is returned if the callback service is unavailable or the availability check for getTaskResult has failed. In these cases, new task creation is blocked to prevent users from paying for tasks whose results cannot be received. Try the request again later. If you are using a callback, make sure the specified callback URL is accessible.
INVALID TASK
API error code: ERROR_INVALID_TASK
The request is syntactically valid but contains invalid data required to create a task. For example, required fields may be missing, contain invalid values, or contain expired data, making it impossible to solve the CAPTCHA. The errorDescription field specifies which request fields are invalid and how to fix them. Check the task parameters, verify that the submitted data is up to date, and correct the fields specified in errorDescription. If you are unable to resolve the issue yourself, please contact support.
