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 report 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


Request example

curl -i -H "Accept: application/json" \
     -H "Content-Type: application/json" \
     -X POST -d '{

Response structure

errorIdIntegerError identifier.
0 - no errors, operation completed successfully.
>0 - error identifier. Error code with short description are available in errorCode and errorDescription properties.
errorDescriptionStringShort description of the error
statusStringThe 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