Documentation menu

reportCorrectRecaptcha: report correctly solved Recaptcha tokens

Use this method along with reportIncorrectRecaptcha for your Recaptcha V3 and Recaptcha V2 Enterprise tasks. Reports for Recaptcha V2 are currently accepted but eventually ignored. Our quality for V2 is about 99%, and you don't need to build a whitelist of successful workers.

Behind the scenes, we will put the worker you've reported on a whitelist, and at the next round of assigning workers to your captchas, our system will match this whitelist with your captchas. If any of the reported workers are online and idle, they will be put at the front of the line for assignment to your new task. The system will keep this record for the next hour and may remove it if you send a reportIncorrectRecaptcha request for a task, which is executed by the same whitelisted worker.
In short: reportCorrectRecaptcha adds workers to your whitelist, reportIncorrectRecaptcha removes them from it.

Reporting correctly solved tokens works on noticeable volumes, starting from 10 tasks per minute. This is due to the heavy migration of our workers between different task queues and their current busy/idle status. With volumes like 1 task per minute, you won't notice any improvements in quality.

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.

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, 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
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."