Getting Started
-
Get your API key
Open the Supersim Telegram bot and press API Key → Update API Key. Your new key is shown only once — store it somewhere safe.
Your key is a
supersim_prefix followed by 64 hexadecimal characters. It is stored hashed on our servers and can never be recovered; if you lose it, regenerate it from the bot. -
Point your code at the base URL
All requests go to the same base URL:
https://su-persim.uz/api/v1The store API is RESTful and returns JSON. Every endpoint except
GET /stockrequires theX-API-Keyheader. -
Make your first request
Check the live stock and prices before buying:
GET /api/v1/stock import requestsresp = requests.get("https://su-persim.uz/api/v1/stock",headers={"X-API-Key": "supersim_YOUR_API_KEY"},)stock = resp.json()for country in stock:print(f"{country['flag_emoji']} {country['country_name']}: "f"{country['stock_ready']} ready / {country['stock_session']} sessions")GET /api/v1/stock <?php$ch = curl_init("https://su-persim.uz/api/v1/stock");curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: supersim_YOUR_API_KEY",]);$body = curl_exec($ch);curl_close($ch);foreach (json_decode($body, true) as $country) {echo "{$country['flag_emoji']} {$country['country_name']}: ". "{$country['stock_ready']} ready / {$country['stock_session']} sessions\n";}GET /api/v1/stock const res = await fetch("https://su-persim.uz/api/v1/stock", {headers: { "X-API-Key": "supersim_YOUR_API_KEY" },});const stock = await res.json();for (const country of stock) {console.log(`${country.flag_emoji} ${country.country_name}: ` +`${country.stock_ready} ready / ${country.stock_session} sessions`);} -
Complete your first purchase
Buying is a single call. Pass an optional
Idempotency-Keyheader so a retried request never charges you twice:POST /api/v1/buy import requestsresp = requests.post("https://su-persim.uz/api/v1/buy",headers={"X-API-Key": "supersim_YOUR_API_KEY","Idempotency-Key": "order-abc-123",},json={"country_id": 1, "account_type": "ready"},)print(resp.status_code)print(resp.json())POST /api/v1/buy <?php$ch = curl_init("https://su-persim.uz/api/v1/buy");curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_POST, true);curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: supersim_YOUR_API_KEY","Content-Type: application/json","Idempotency-Key: order-abc-123",]);curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode(["country_id" => 1,"account_type" => "ready",]));$response = curl_exec($ch);curl_close($ch);echo $response;POST /api/v1/buy const res = await fetch("https://su-persim.uz/api/v1/buy", {method: "POST",headers: {"Content-Type": "application/json","X-API-Key": "supersim_YOUR_API_KEY","Idempotency-Key": "order-abc-123",},body: JSON.stringify({ country_id: 1, account_type: "ready" }),});console.log(res.status);console.log(await res.json());The response includes your
order_id, the account’s phone number, and its 2FA password. -
Fetch the OTP and finalize
GET /api/v1/otp/{order_id}— wait for the login code.- Log in to Telegram with the phone + password + OTP.
POST /api/v1/logout/{order_id}— logs the bot out of the session so you are the only active session.