Getting data by start token

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

When using the script that transfers data from a website to a bot, or when using redirect links, a unique token is generated and various data is attached to it (UTM tags, custom fields, IP address, etc.)

This token is passed in the start parameter when the bot is launched, for 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:

Retrieving data

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

{token} - replace this with your token, which was passed 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