Documentation menu

reportIncorrectRecaptcha: send complaint on a Recaptcha token

Complaints are accepted for V2 and V3 Recaptchas only, including Enterprise Recaptcha. It is important to read the following description; otherwise, our system may ban your reports.

Because we can't check your report as we do with image captchas, your complaint goes first to our backend for statistics analysis and is only accepted if the results are positive. We compare your report statistics with the statistics of other trusted customers. If your report rate differs significantly from other reports, then it will be ignored for several days. Thus, to ensure the best results, you should always monitor your automation processes and send reports only if you are 100% certain the Recaptcha was wrong.

Not all reports are accepted. To calculate your average fail rate as accurately as possible, a minimum 100 recaptcha tasks per account must be sent for recognition per 24 hours.

Reports must be sent within 60 seconds of task completion. If you send a report later, the API will return ERROR_NO_SUCH_CAPTCHA_ID error. Only one report can be sent per task.

Address: https://api.anti-captcha.com/reportIncorrectRecaptcha
Method: POST
Content-type: application-json

Request properties

Property Type Required Purpose
clientKey String Yes
taskId Integer Yes

Request example

CURL
          curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{
    "clientKey":"YOUR_API_KEY",
    "taskId":12345
}' https://api.anti-captcha.com/reportIncorrectRecaptcha
        


Response structure

Property Type Purpose
errorId Integer Error identifier.
0 - no errors, operation completed successfully.
>1 - error identifier. Error code and short description transferred in errorCode and errorDescription properties.
errorCode String
errorDescription String Short description of the error
status String
The result of the operation. You either receive an error code or status="success" when complaint is accepted.

Response example

JSON with no errors
          {
    "errorId":0,
    "status":"success"
}
        
JSON with an error
          {
    "errorId": 16,
    "errorCode": "ERROR_NO_SUCH_CAPCHA_ID",
    "errorDescription": "Task you are requesting does not exist in your current task list or has been expired."
}