---
title: "Run manual CAPTCHA evaluation"
method: POST
path: "/api/session/{id}/captcha/evaluate"
---

# Run manual CAPTCHA evaluation

`POST /api/session/{id}/captcha/evaluate`

Trigger a bounded CAPTCHA evaluation on an active browser session. Supported CAPTCHA targets are turnstile, cloudflare-challenge, aliexpress, recaptcha, and amazon.

## Path parameters

- `id` string, required

## Request body

- CaptchaEvaluationParams
  - `captcha` 'turnstile' | 'cloudflare-challenge' | 'aliexpress' | 'recaptcha' | 'amazon' — CAPTCHA target to evaluate manually.
  - `captchaType` 'turnstile' | 'cloudflare-challenge' | 'aliexpress' | 'recaptcha' | 'amazon' — CAPTCHA target to evaluate manually.
  - `text` 'turnstile' | 'cloudflare-challenge' | 'aliexpress' | 'recaptcha' | 'amazon' — CAPTCHA target to evaluate manually.
  - `iterations` integer
  - `maxIterations` integer
  - `solverType` 'visual' — Optional CAPTCHA solver mode. Set to visual to use the visual reCAPTCHA solver.
  - `imageCaptchaParams` ImageCaptchaParam[]
    - `imageSelector` string
    - `inputSelector` string
  - `useUltraStealth` boolean

## Response `200`

CAPTCHA evaluation completed

- CaptchaEvaluationResponse
  - `success` boolean
  - `captcha` 'turnstile' | 'cloudflare-challenge' | 'aliexpress' | 'recaptcha' | 'amazon' — CAPTCHA target to evaluate manually.
  - `iterationsRequested` integer
  - `iterationsRun` integer
  - `solved` boolean
  - `solvedCaptchas` CaptchaEvaluationType[]
  - `pages` CaptchaEvaluationPageResult[]
    - `url` string
    - `targetId` string, nullable
    - `iterationsRun` integer
    - `solved` boolean
    - `solvedCaptchas` CaptchaEvaluationType[]
    - `checkedCaptchas` CaptchaEvaluationType[]
    - `captchaSolvedCounts` object
    - `lastSolveTime` object

## Other responses

- `400` — Invalid evaluation request
- `404` — Session not found
- `409` — CAPTCHA evaluation is already running
- `500` — Server error

---

[API](https://skmtc.net/hyperbrowser/apis/hyperbrowser-api.md) · [All operations](https://skmtc.net/hyperbrowser/apis/hyperbrowser-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/hyperbrowser/hyperbrowser-api/versions/69aa004ce41b/schema)