report

report tells us whether a group of task results was right. Image recognition tasks reported as wrong are refunded after about 24 hours if they qualify, and reports also help improve recognition. Please report correct results as well.

POSThttps://api.yescaptcha.com/reportGlobal endpointCopy

POSThttps://cn.yescaptcha.com/reportChina endpointCopy

Request fields

Field	Type	Required	Description
id	array of string	Yes	Task IDs; you can report several at once
isSuccess	boolean	Yes	true if the result was correct, false if it was wrong

No clientKey is needed; the task IDs identify the tasks.

{
  "id": ["610ff5e0-68eb-11ef-95a6-22e70a0b794d", "65b88c06-68eb-11ef-8e9a-52540023ccb3"],
  "isSuccess": false
}

When one challenge takes several images (for example five rounds of FunCaptcha) and the final submission fails without telling you which round was wrong, report the whole group of task IDs together.

Response

{ "errorId": 0, "status": "success" }

Refunds for failed reports

• Only 5 image recognition types are refunded: FunCaptchaClassification, HCaptchaClassification, ReCaptchaV2Classification, AwsClassification and bCaptchaClassification.
• Only reports made within 1 hour of creating the task count, and each task is refunded at most once.
• Refunds are settled after about 24 hours, not immediately.
• At settlement, your reported failure rate is compared with other users on the same questions in the same period; if yours is clearly higher, you are refunded at the period’s failure rate.
• If you disagree with a settlement, contact support.

For token types (reCAPTCHA, hCaptcha, Turnstile, FunCaptcha and so on), the target site decides whether a token passes, so reports are not refunded. All billing rules: Billing and refunds.