Call a method

A call gives an account a job and immediately returns its ID. You fetch the result by that ID — by polling or with one long request.

Pass the key

The key goes in the header of every request:

Authorization: Bearer igrm_…

A method runs only if the key has the required scope. The API address and ready examples are on the Documentation tab of the API section.

Call

Each method has its own address: POST /api/v1/public/methods/<method>. The body holds account_id — the account to act as — and the method’s parameters.

POST /api/v1/public/methods/resolve_username
{"account_id": "…", "username": "coffee_lab_demo"}

You get back a job_id, the job’s ID.

Fetch the result

GET /api/v1/public/jobs/<job_id> returns the job’s status and, once it’s done, the result in the result field or an error in the error field.

To avoid polling in a loop, add ?wait=30: the request waits up to 30 seconds and responds as soon as the job finishes.

Results are kept for 7 days.

Which account

Only an account from your package. The call is rejected right away if the account is banned by Telegram or the package isn’t paid. The method uses the account’s daily limit for the action, and the account’s restrictions apply to the API the same way as in the dashboard.