POST /api/captcha/:id/report — Report

Report an incorrectly solved CAPTCHA to get your money back. The charge is refunded and negative feedback is recorded in the routing engine’s reliability scores.

Endpoint

POST https://api.ucaptcha.net/api/captcha/:id/report

Replace :id with the task ID (captcha value from submit).

Authentication

Either method is accepted:

authtoken field in the POST body
HTTP Basic auth — username = your uCaptcha API key

Parameters

Parameter	Type	Required	Description
`authtoken`	string	Yes*	Your uCaptcha API key

* Or use HTTP Basic auth instead.

Response

Success (200)

Report accepted, credits refunded:

{
  "captcha": "TASK_ID",
  "is_correct": false,
  "solved": true,
  "text": ""
}

Not Found (503)

Task not found or not owned by this user:

{
  "status": 255,
  "error": "Captcha not found or not owned by this user"
}

Examples

cURL

curl -X POST https://api.ucaptcha.net/api/captcha/550e8400-e29b-41d4-a716-446655440000/report \
  -d "authtoken=YOUR_API_KEY"

Python

import requests

requests.post(
    "https://api.ucaptcha.net/api/captcha/TASK_ID/report",
    data={"authtoken": "YOUR_API_KEY"}
)