reportIncorrectRecaptcha: send complaint on a reCaptcha token
Complaints are accepted for V2 and V3 reCaptchas only, including Enterprise reCaptchas. You must read the following description; otherwise, our system may ban your reports.
Because we can't check your report as what 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 of 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_CAPCHA_ID error. Only one report can be sent per task.
Because we can't check your report as what 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 of 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_CAPCHA_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 -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. >0 - error identifier. Error code with short description are available 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 the complaint is accepted. |
Response example
JSON with no errors
JSON with an error
{
"errorId":0,
"status":"success"
}