> For the complete documentation index, see [llms.txt](https://docs.graspil.com/ru/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.graspil.com/ru/api/get-data-by-start-token.md).

# Получение данных по стартовому токену

Метод предназначен для получения данных о пользователе со стартовым токеном.

При использовании скрипта переноса данных с сайта в бот или при использовании ссылок с переадресацией генерируется уникальный токен к которому привязываются различные данные (utm-метки, доп. поля, ip адрес и т.д.)

Этот токен подставляется в параметр `start` при запуске бота, пример: `https://t.me/graspil_bot?start=bai38kal`

Если при запуске бота вам нужно получить данные об этом токене вы можете использовать метод который описан ниже:

## Получение данных

<mark style="color:green;">`GET`</mark> `/v1/get-data-by-start-token?token={token}`

`{token}` - нужно заменить на ваш токен, который пришел вам в параметре `start`

#### Ответ

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

```json
{
    "ok": true,
    "data": {
        "data": {
            "ip": "1.1.1.1",
            "gmt": 1,
            "utm": [
                "source": "test"
            ],
            "params": {
                "my_field": "on"
            }
        },
        "date": "2025-10-16 21:04:11",
        "host": "https://graspil.com"
    }
}
```

{% endtab %}

{% tab title="404" %}

```json
{
    "ok": false,
    "error_code": 404,
    "description": "Not Found"
}
```

{% endtab %}
{% endtabs %}