Documentation menu

reportIncorrectRecaptcha: send complaint on a Recaptcha token

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

Due to inability to check your report like we do with image captchas, your complaint first passes statistics analysis in our backend, and afterwards accepted only in case of its positive outcome. What we basically do is comparing your reports statistics with statistics of other trusted customers. If your report rate has too high difference from other reports, then it will be ignored for a period of several days. Thus, for best results you should always monitor your automation processes and send reports only in case when you are 100% sure Recaptcha was wrong.

Not all reports are accepted. In order to calculate your average fails rate with proper level of accuracy, minimum 100 of recaptcha tasks per account must be sent for recognition per 24 hours.

Reports must be sent within 60 seconds after task completion. If you send report later, API will return ERROR_NO_SUCH_CAPTCHA_ID error. It is allowed to send only one report per task.

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 '{

Response structure

Property Type Purpose
errorId Integer Error identifier.
0 - no errors, the 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
Result of the operation. You either receive an error code or status="success" when complaint is accepted.

Response example

JSON with no errors
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."