Get data by start token

This method is designed to retrieve user data associated with a start token.

When using a script to transfer data from the website to the bot, or when using redirect links, a unique token is generated. Various data (UTM parameters, additional fields, IP address, etc.) are linked to this token.

This token is then inserted into the start parameter when launching the bot. Example: https://t.me/graspil_bot?start=bai38kal

If you need to retrieve the data associated with this token when the bot is launched, you can use the method described below:

Get data

GET /v1/get-data-by-start-token?token={token}

{token} — should be replaced with your token received in the start parameter.

Response

200

{
    "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"
    }
}

404

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