FAQ
General
Section titled “General”Where do I get an API key?
Section titled “Where do I get an API key?”Open the Supersim Telegram bot and use the API Key section. Your key is shown only once — save it immediately. If you lose it, regenerate it from the bot.
How do I add balance?
Section titled “How do I add balance?”Top up your wallet inside the Telegram bot (or from the account panel). The balance is shared between the bot and the API.
Is the API free?
Section titled “Is the API free?”The API itself is free to use; you only pay for the accounts you purchase.
Accounts & sessions
Section titled “Accounts & sessions”What is the difference between ready and session?
Section titled “What is the difference between ready and session?”- Ready: an already-logged-in Telegram account. You fetch the OTP and log in yourself — most common.
- Session: the
.session+.jsonfiles for an account, which you download as a ZIP and use directly in your own client (e.g.Telethon,Pyrogram,MTProto).
Can I download a session for a ready account?
Section titled “Can I download a session for a ready account?”No. Session downloads are only available for account_type: "session" orders.
Why should I call /logout?
Section titled “Why should I call /logout?”Logging the store’s bot out guarantees you are the only active session on the account, and stops the server from receiving further messages. It also cleans up the session files.
Purchases & warranties
Section titled “Purchases & warranties”What if the OTP never arrives?
Section titled “What if the OTP never arrives?”The API polls for up to a few minutes and stores the latest code. Try GET /api/v1/otp/{order_id} again later. If it still fails, run POST /api/v1/orders/{order_id}/validate and contact support with the order_id.
What is the warranty period?
Section titled “What is the warranty period?”Use the validate endpoint to check an account. If an account is invalid, our support team will replace it.
Will I be charged twice if my request times out?
Section titled “Will I be charged twice if my request times out?”No — as long as you send an Idempotency-Key header. The same key returns the same order without charging again.
Webhooks
Section titled “Webhooks”Do webhooks retry on failure?
Section titled “Do webhooks retry on failure?”Not in this version. Ensure your endpoint returns 2xx quickly and is reachable over HTTPS.
Is my webhook URL secure?
Section titled “Is my webhook URL secure?”The URL is stored on our side and sent nothing else. Anyone who knows the URL can receive your OTP events, so keep it secret and use HTTPS.
Limits
Section titled “Limits”What are the rate limits?
Section titled “What are the rate limits?”10 requests per 10 seconds per API key. See Errors & Rate Limits.
Can I increase my limits?
Section titled “Can I increase my limits?”Contact support and we can raise the limits for your key.