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 to a whitelist, and at the next round of assigning workers to your captchas our system will match this white list with your captchas. If any of the reported workers is online and idle, he or she will be put in the first line to take assignment for your new task. System will keep this record for the next hour and may remove it if you send reportIncorrectRecaptcha request for a task, which is executed by the same worker from the white list.
Shortly said, reportCorrectRecaptcha adds workers to your whitelist, reportIncorrectRecaptcha removes them.

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

Reports must be sent within 60 seconds after task completion. If you send report later, API will return ERROR_NO_SUCH_CAPCHA_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."