Getting started

Prerequisites

• Your API token (available in the bot’s personal cabinet).
• Any HTTP client: curl, Python, Node.js, Postman.

Base URL

https://api.telesint.dev

All endpoints live under /v1/.

First request

Use the free /v1/me/ endpoint to verify your token and check the balance:

curl -H "Api-Key: YOUR_API_KEY" https://api.telesint.dev/v1/me/

Successful response:

{
  "id_": 436307416,
  "balance": 109992,
  "multiplier": 1,
  "roles": [
    {
      "name": "user",
      "description": null,
      "scopes": [
        { "name": "read_users", "description": null },
        { "name": "read_groups", "description": null },
        { "name": "search", "description": null }
      ]
    }
  ],
  "notification_threshold": 20
}

If you get a 401, check the token. If balance is low, top it up before calling paid endpoints — paid calls with insufficient balance return 400 with {"detail": "Not enough balance..."} and do not charge.

What to read next

1. Authentication — how to pass the token.
2. Rate limits — request and concurrency quotas.
3. Pricing — per-endpoint cost.
4. Errors — error shapes.