API Reference

Full reference for all CapBypass API endpoints.

Base URL: https://api.capbypass.pro

Endpoints

POST /createTask

Create a new task for solving.

Request Body

{
  "clientKey": "YOUR_API_KEY",
  "developerKey": "OPTIONAL_DEV_KEY",
  "task": {
    "type": "ReCaptchaV3TaskProxyLess",
    "websiteURL": "https://example.com",
    "websiteKey": "6LdyC2cUAAAAACGuDKpXeDorzUDWXmdqeg-xy696",
    "pageAction": "login"
  }
}

Common Parameters

reCAPTCHA Parameters

Applies to ReCaptchaV2Task*, ReCaptchaV3Task*, ReCaptchaV3EnterpriseTask*.

See the reCAPTCHA v3 guide for details.

AWS WAF Parameters

Applies to AntiAwsWafTask / AntiAwsWafTaskProxyLess.

See the AWS WAF guide for details.

GeeTest Parameters

Applies to GeetestTask / GeetestTaskProxyLess (v3 and v4).

See the GeeTest guide for details.

Response

{
  "errorId": 0,
  "taskId": "uuid"
}

Proxy Format

For task types that require a proxy (non-ProxyLess variants), provide the proxy as a string in the task.proxy field.

Both the URL form and the colon-delimited form are accepted. Supported protocols: http, https, socks4, socks5 (defaults to http when omitted).

Examples:

http://1.2.3.4:8080
http://user:[email protected]:8080
socks5://user:[email protected]:1080
1.2.3.4:8080:myuser:mypass
socks5:1.2.3.4:1080:myuser:mypass

POST /getTaskResult

Poll for task completion.

Request Body

{
  "clientKey": "string (required)",
  "taskId": "string (required)"
}

Response (Processing)

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

Response (Ready - reCAPTCHA)

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "gRecaptchaResponse": "03AGdBq24PBCb...",
    "userAgent": "Mozilla/5.0 ...",
    "secChUa": "\"Chromium\";v=\"136\", ..."
  }
}

Response (Ready - AWS WAF)

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "cookie": "aws-waf-token=xxxxxxxx...",
    "token": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx:...",
    "captchaVoucher": "eyJ...",
    "userAgent": "Mozilla/5.0 ..."
  }
}

captchaVoucher is only returned for the visual-CAPTCHA flow — submit it to the Amazon CVF endpoint /aaut/verify/cvf/{jwt}.

Response (Ready - GeeTest v4)

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "captcha_id": "fcd636b4514bf7ac4143922550b3008b",
    "lot_number": "354ab6dd4e594fd...",
    "pass_token": "f5c8...",
    "gen_time": "1716950400",
    "captcha_output": "Hk2x...",
    "userAgent": "Mozilla/5.0 ..."
  }
}

Submit lot_number, pass_token, gen_time, and captcha_output as the verification form params.

Response (Ready - GeeTest v3)

{
  "errorId": 0,
  "status": "ready",
  "solution": {
    "challenge": "3c1b...ab",
    "validate": "5e2f...",
    "seccode": "5e2f...|jordan",
    "userAgent": "Mozilla/5.0 ..."
  }
}

Submit challenge, validate, and seccode as the verification form params.

Response (Failed)

{
  "errorId": 1,
  "status": "failed",
  "errorCode": "ERROR_CAPTCHA_UNSOLVABLE",
  "errorDescription": "Unable to solve the challenge"
}

POST /getBalance

Check your account balance.

Request Body

{
  "clientKey": "string (required)"
}

Response

{
  "errorId": 0,
  "balance": 123.45
}

GET /pricing

Get current pricing for all task types. No authentication required.

user_cost is the price per single solve (multiply by 1000 for the per-1K figure).

Response

The example below is pulled live from the production /pricing endpoint:

{
  "pricing": [
    {
      "task_type": "AntiAwsWafMobileTask",
      "user_cost": 0.0013,
      "status": "active",
      "solver": "waf"
    },
    {
      "task_type": "AntiAwsWafTask",
      "user_cost": 0.0013,
      "status": "active",
      "solver": "waf"
    },
    {
      "task_type": "AntiAwsWafTaskProxyLess",
      "user_cost": 0.0013,
      "status": "active",
      "solver": "waf"
    },
    {
      "task_type": "CaptchaFoxTask",
      "user_cost": 0.003,
      "status": "active",
      "solver": "captchafox"
    },
    {
      "task_type": "CaptchaFoxTaskProxyLess",
      "user_cost": 0.003,
      "status": "active",
      "solver": "captchafox"
    },
    {
      "task_type": "GeetestTask",
      "user_cost": 0.00099,
      "status": "active",
      "solver": "geetest"
    },
    {
      "task_type": "GeetestTaskProxyLess",
      "user_cost": 0.00099,
      "status": "active",
      "solver": "geetest"
    },
    {
      "task_type": "ReCaptchaV3EnterpriseTask",
      "user_cost": 0.002,
      "status": "active",
      "solver": "recaptcha"
    },
    {
      "task_type": "ReCaptchaV3EnterpriseTaskProxyLess",
      "user_cost": 0.002,
      "status": "active",
      "solver": "recaptcha"
    },
    {
      "task_type": "ReCaptchaV3Task",
      "user_cost": 0.0006,
      "status": "active",
      "solver": "recaptcha"
    },
    {
      "task_type": "ReCaptchaV3TaskProxyLess",
      "user_cost": 0.0006,
      "status": "active",
      "solver": "recaptcha"
    }
  ]
}

GET /health

Health check endpoint. Returns 200 OK when the API is operational.

Response

{
  "status": "ok"
}

Error Codes