> For the complete documentation index, see [llms.txt](https://docs.hmcaptcha.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.hmcaptcha.com/recognition-api/slide-captcha.md).

# SLIDE Captcha

## Create task

<mark style="color:green;">`POST`</mark> `https://hmcaptcha.com/Recognition`

**SLIDE CAPTCHA**

<img src="/files/n6G3PK74n2h1eLZ9wloI" alt="" data-size="original">![](/files/TpMTKoJAQ1Y3SjJWlW9c)![](/files/QvcUTIuHsxsHIVe7qmzr)

![](/files/eXV0ajMuFncadusPE2ki)![](/files/nKhVJdbjKGPQUuX3NrzI)![](/files/SSnfq3tgW3eMYNEXOaj0)

**Example** [`https://hmcaptcha.com/recognition`](https://hmcaptcha.com/recognition)

`{`\
&#x20;    `"Apikey": "YOUR APIKEY",`\
&#x20;    `"Type": "ALL_CAPTCHA_SLIDE",`\
&#x20;    `"Image": "Image as base64 encoded"`\
`}`

#### Query Parameters

| Name | Type | Description                                                                                                                                       |
| ---- | ---- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| wait | Bool | If the 'wait=1' parameter is added to the URL, the result will return immediately after the captcha is solved without needing to call 'getResult' |

#### Headers

| Name         | Type   | Description      |
| ------------ | ------ | ---------------- |
| Content-Type | String | application/json |

#### Request Body

| Name                                     | Type   | Description                                                                                                                                    |
| ---------------------------------------- | ------ | ---------------------------------------------------------------------------------------------------------------------------------------------- |
| Apikey<mark style="color:red;">\*</mark> | String | The apikey or subscription key                                                                                                                 |
| Type<mark style="color:red;">\*</mark>   | String | <p><code>ALL\_CAPTCHA\_SLIDE</code><br><code>TIKTOK\_OBJ</code><br><code>TIKTOK\_ROTATE\_APP</code></p><p><code>TIKTOK\_ROTATE\_WEB</code></p> |
| Image                                    | String | Image encoded as base64                                                                                                                        |
| ref                                      | String | Add to get referral money                                                                                                                      |

{% tabs %}
{% tab title="200: OK OK" %}

```json
{
    "Code": 0,
    "TaskId": 123456,
    "Message": "OK"
}
```

{% endtab %}

{% tab title="200: OK FAILED" %}

```json
{
    "Code": 1,
    "Message": "Error description"
}
```

{% endtab %}
{% endtabs %}

## Get result

<mark style="color:blue;">`GET`</mark> `https://hmcaptcha.com/getResult?apikey={your_apikey}&taskid={taskid}`

**Example** [`https://hmcaptcha.com/getResult?apikey=admingoiZ4dxa1GNHH!Rt0He8KEnrfYJCz3JE&taskid=12345`](https://hmcaptcha.com/getResult?apikey=admingoiZ4dxa1GNHH!Rt0He8KEnrfYJCz3JE\&taskid=12345)

#### Query Parameters

| Name                                     | Type   | Description                          |
| ---------------------------------------- | ------ | ------------------------------------ |
| apikey<mark style="color:red;">\*</mark> | String | The user apikey. Get it in dashboard |
| taskid<mark style="color:red;">\*</mark> | String | The task id from Create Task step    |

{% tabs %}
{% tab title="200: OK PENDING - repeat the request until Status = SUCCESS or ERROR" %}

```json
{
    "Code": 0,
    "Status": "PENDING",
    "Data": null
}
```

{% endtab %}

{% tab title="200: OK PROCESSING - repeat the request until Status = SUCCESS or ERROR" %}

```json
{
    "Code": 0,
    "Status": "PROCESSING",
    "Data": null
}
```

{% endtab %}

{% tab title="200: OK SUCCESS" %}

```json
{
    "Code": 0,
    "Status": "SUCCESS",
    "Data": {
            "offset": 78, // Drag to right 78px
            "x": 210,
            "y": 652 // point button slide
        }
}
```

{% endtab %}

{% tab title="200: OK ERROR" %}

```json
{
    "Code": 0,
    "Status": "ERROR",
    "Message": "Error message detail"
    "Data": null
}
```

{% endtab %}
{% endtabs %}