Report a correct token

POST https://api.noptcha.com/reportCorrectRecaptcha

Compatibility API (anti-captcha compatible). Guide. Operation ID compatReportCorrectRecaptcha.

Reports whether a solved task's answer worked. Accepted for solved tasks within 10 minutes after completion; only the first report per task counts, later ones still succeed. Reports are recorded as a quality signal; they do not refund the task. Unsolved or unknown tasks: ERROR_NO_SUCH_CAPCHA_ID.

Request

Authentication: the key in the clientKey body field (Keys).

Body (application/json, required):

Field	Type	Description
`clientKey` required	`string`	Your key (`nop_live_…` or `nop_test_…`).
`taskId` required	`one of`	The task ID, as a number or a string of digits. one of: `integer`, `string`

Responses

200

Recorded (errorId 0) or an error.

Headers: Noptcha-Request-Id.

Content: application/json

One of:

CompatReportResult
CompatError — A request or task error. errorCode values (anti-captcha's codes; new ones may be added):

403

forbidden (problem details): the request reached the API without passing through our edge network. Infrastructure, not part of the compatibility protocol.

Headers: Noptcha-Request-Id.

Content: application/problem+json

Field	Type	Description
`code` required	`string`	Machine-readable error code (see the table).
`detail` optional	`string`	Human-readable explanation of this occurrence.
`request_id` required	`string`	Same as the `Noptcha-Request-Id` header.
`status` required	`integer`	The HTTP status code.
`title` required	`string`
`type` required	`string`	format: uri

500

internal: an error on our side.

Headers: Noptcha-Request-Id, RateLimit (optional), RateLimit-Policy (optional).

Content: application/problem+json

Field	Type	Description
`code` required	`string`	Machine-readable error code (see the table).
`detail` optional	`string`	Human-readable explanation of this occurrence.
`request_id` required	`string`	Same as the `Noptcha-Request-Id` header.
`status` required	`integer`	The HTTP status code.
`title` required	`string`
`type` required	`string`	format: uri

About the compatibility API:

The anti-captcha compatible JSON protocol.

Requests are POST with a JSON body. Content-Type is not required; the body is always parsed as JSON.
The key goes in clientKey. The key is checked before anything else, so an invalid key is reported even when other fields are wrong.
Responses are always HTTP 200. errorId is 0 on success and 1 on error; then errorCode and errorDescription say what went wrong (see CompatError for every code).
Two responses come from the infrastructure, not from the protocol: 403 (problem details, code forbidden) when a request reaches the API without passing through our edge network, and 500 (code internal) on an unexpected server error. Treat both as transient errors.
An unknown path, or a known path with another method (for example GET /createTask), is 404 (problem details, code not_found).
Task type names are the common anti-captcha compatible names (case-insensitive); each maps to a canonical type and variant, see CompatTaskType.
callbackUrl (optional) receives the final result as a POST (see Webhooks and the compatCallback webhook). An invalid URL is ERROR_INCORRECT_SESSION_DATA and no task is created.

Header descriptions and every schema: Schemas. Machine-readable: openapi.json, openapi.yaml.