> For the complete documentation index, see [llms.txt](https://docs.takionapi.tech/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.takionapi.tech/geetest/v4.md).

# v4 Bypass Solution

### How the solution works <a href="#how-the-solution-works" id="how-the-solution-works"></a>

To bypass a GeeTest v4 captcha:

1. Parse the `captcha_id` and (optionally) `kind` from the captcha. The kind defaults to `ai` but may vary based on the captcha type (for example slide, puzzle, icon).
2. Send the `captcha_id` to our API, and retrieve the response.

### Endpoint <a href="#endpoint" id="endpoint"></a>

```
GET https://geetest.takionapi.tech/v4
```

### **Parameters**:

* **captcha\_id** (required): The captcha's `captcha_id`.
* **kind** (optional): The type of captcha to solve (defaults to "slide").
* **proxy** (optional): Proxy for solving (format: `ip:port` or `ip:Port:mail:password`).

### **Example Response**:

```json
{
  "response": {
    "captcha_id": "fcd636b4514bf7ac4143922550b3008b",
    "lot_number": "e4c0b946b91c4aeabbc343b9a0f048ca",
    "pass_token": "4856da4c49ca...3edea00d688e",
    "gen_time": "1725490466",
    "captcha_output": "Vt45iXQep...=="
  }
}
```

{% hint style="info" %}
In order to access any of our endpoint you'll need **a valid API Key,** either [join our discord](https://takionapi.tech/discord) for a trial or [puchase a plan](https://takionapi.tech/buy)
{% endhint %}

## Solve GeeTest v4

> Solves a GeeTest v4 captcha from its \`captcha\_id\` and returns the validated solution (\`lot\_number\`, \`pass\_token\`, \`gen\_time\`, \`captcha\_output\`) under \`response\`. GET with query params also works.<br>

```json
{"openapi":"3.0.3","info":{"title":"Takion API — GeeTest","version":"1.0.0"},"servers":[{"url":"https://geetest.takionapi.tech"}],"security":[{"ApiKeyHeader":[]},{"ApiKeyQuery":[]}],"components":{"securitySchemes":{"ApiKeyHeader":{"type":"apiKey","in":"header","name":"x-api-key"},"ApiKeyQuery":{"type":"apiKey","in":"query","name":"api_key"}},"schemas":{"V4Request":{"type":"object","required":["captcha_id"],"properties":{"captcha_id":{"type":"string","description":"The GeeTest v4 `captcha_id` from the target."},"kind":{"type":"string","description":"Challenge kind.","default":"ai"},"proxy":{"type":"string","description":"Proxy in `ip:port` or `ip:port:user:pass` format (optional)."}},"additionalProperties":true},"SolveResponse":{"type":"object","properties":{"response":{"type":"object","description":"The validated GeeTest solution — v3 carries `geetest_challenge`/`geetest_validate`/`geetest_seccode`; v4 carries `lot_number`/`pass_token`/`gen_time`/`captcha_output`.\n","additionalProperties":true}},"additionalProperties":true},"Error":{"type":"object","required":["error"],"description":"Every error is a JSON object with a single `error` string. Missing input returns 400, auth/quota 401, and an unsolvable captcha or unexpected failure returns 500.\n","properties":{"error":{"type":"string"}}}},"responses":{"Unauthorized":{"description":"Authentication or quota failure — HTTP 401 with an `error` message.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}},"paths":{"/v4":{"post":{"operationId":"solveGeetestV4","summary":"Solve GeeTest v4","description":"Solves a GeeTest v4 captcha from its `captcha_id` and returns the validated solution (`lot_number`, `pass_token`, `gen_time`, `captcha_output`) under `response`. GET with query params also works.\n","requestBody":{"required":true,"content":{"application/json":{"schema":{"$ref":"#/components/schemas/V4Request"}}}},"responses":{"200":{"description":"The solved v4 payload under `response`.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/SolveResponse"}}}},"400":{"description":"Missing input.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"401":{"$ref":"#/components/responses/Unauthorized"},"500":{"description":"The captcha could not be solved, or an unexpected error.","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}}}}}}
```