Reporting outcomes

Telling Capzy whether a solve actually worked at the target improves routing and quality. Reporting is optional but recommended, especially for reCAPTCHA v3 and coordinate-return types.

reportScore (reCAPTCHA v3)

reCAPTCHA v3 returns a risk score rather than a pass/fail. If you can observe the score the target assigned to a token, report it back with /reportScore. This feeds your dashboard v3 quality metrics and improves how Capzy routes future v3 solves.

report-score.sh

curl -s https://api.capzy.ai/reportScore \
  -H 'Content-Type: application/json' \
  -d '{
    "clientKey": "capzy_YOUR_KEY",
    "taskId": "df94a1c2-...",
    "score": 0.9,
    "action": "login",
    "hostname": "example.com"
  }'
# -> { "errorId": 0 }

Send the score as a float between 0 and 1. The action and hostname fields are optional context. Constraints: the task must be a reCAPTCHA v3 task in ready status, the report must arrive within 24 hours, and only one report is accepted per task.

reportCorrectCaptcha and reportIncorrectCaptcha

For any solve, tell Capzy whether the target accepted or rejected it. This is most valuable for coordinate-return types, where only the target knows if the clicks landed correctly.

Report an accepted solve:

report-correct.sh

curl -s https://api.capzy.ai/reportCorrectCaptcha \
  -H 'Content-Type: application/json' \
  -d '{ "clientKey": "capzy_YOUR_KEY", "taskId": "df94a1c2-..." }'
# -> { "errorId": 0 }

Report a rejected solve:

report-incorrect.sh

curl -s https://api.capzy.ai/reportIncorrectCaptcha \
  -H 'Content-Type: application/json' \
  -d '{ "clientKey": "capzy_YOUR_KEY", "taskId": "df94a1c2-..." }'
# -> { "errorId": 0 }

Reporting rules

All reports share the same constraints: the task must be in ready status, the report must arrive within 24 hours of the solve, and each task can be reported only once. Reporting a task that was never found returns ERROR_TASK_NOT_FOUND; reporting one that is not ready returns ERROR_TASK_NOT_READY; reporting too late returns ERROR_REPORT_TOO_LATE.

A successful report returns errorId: 0. See Errors for the reporting error codes and Getting the result for the solution shapes these reports refer to.

Using proxies

Errors