Endpoints
/api/v1/stockList all active countries with prices and available stock. This is the only endpoint that does not require authentication.
import requests
resp = requests.get( "https://su-persim.uz/api/v1/stock",)print(resp.json())<?php
$ch = curl_init("https://su-persim.uz/api/v1/stock");curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);echo curl_exec($ch);curl_close($ch);const res = await fetch("https://su-persim.uz/api/v1/stock");console.log(await res.json());Response — 200 OK
[{ "country_id": 1, "country_name": "Italy", "country_code": "IT", "flag_emoji": "🇮🇹", "price_ready": 1.5, "price_session": 1.2, "stock_ready": 12, "stock_session": 7}]Orders
Section titled “Orders”/api/v1/orders?page=1&per_page=20Paginated list of your orders with their current status. Status is one of `paid`, `otp_ready`, or `completed`.
import requests
resp = requests.get( "https://su-persim.uz/api/v1/orders", headers={"X-API-Key": "supersim_YOUR_API_KEY"}, params={"page": 1, "per_page": 20},)print(resp.json())<?php
$ch = curl_init( "https://su-persim.uz/api/v1/orders?page=1&per_page=20");curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: supersim_YOUR_API_KEY"]);echo curl_exec($ch);curl_close($ch);const res = await fetch("https://su-persim.uz/api/v1/orders?page=1&per_page=20",{ headers: { "X-API-Key": "supersim_YOUR_API_KEY" } });console.log(await res.json());Response — 200 OK
{"total": 1,"page": 1,"per_page": 20,"items": [ { "order_id": 42, "phone_number": "+393791700000", "country_name": "Italy", "account_type": "ready", "price": 1.5, "status": "otp_ready", "created_at": "2026-08-15T18:00:00" }]}/api/v1/orders/{order_id}Full details for a single order, including OTP readiness, download availability, and the 2FA password.
import requests
resp = requests.get( f"https://su-persim.uz/api/v1/orders/{order_id}", headers={"X-API-Key": "supersim_YOUR_API_KEY"},)print(resp.json())<?php
$ch = curl_init( "https://su-persim.uz/api/v1/orders/{$order_id}");curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_HTTPHEADER, ["X-API-Key: supersim_YOUR_API_KEY"]);echo curl_exec($ch);curl_close($ch);const res = await fetch(`https://su-persim.uz/api/v1/orders/${orderId}`,{ headers: { "X-API-Key": "supersim_YOUR_API_KEY" } });console.log(await res.json());Response — 200 OK
{"order_id": 42,"phone_number": "+393791700000","country_name": "Italy","account_type": "session","price": 1.2,"status": "paid","created_at": "2026-08-15T18:00:00","otp_ready": false,"password_2fa": "7z6yxsr","can_download": true,"can_logout": true}/api/v1/otp/{order_id}Fetch the latest Telegram login code (OTP) for a purchased account. Keep calling until `otp_code` is present. Requires the buyer's API key.
import timeimport requests
order_id = 42while True: resp = requests.get( f"https://su-persim.uz/api/v1/otp/{order_id}", headers={"X-API-Key": "supersim_YOUR_API_KEY"}, ) data = resp.json() if data.get("otp_code"): print("Code:", data["otp_code"]) break time.sleep(5)<?php
$orderId = 42;while (true) { $ch = curl_init( "https://su-persim.uz/api/v1/otp/{$orderId}" ); curl_setopt($ch, CURLOPT_RETURNTRANSFER, true); curl_setopt($ch, CURLOPT_HTTPHEADER, [ "X-API-Key: supersim_YOUR_API_KEY", ]); $data = json_decode(curl_exec($ch), true); curl_close($ch);
if (!empty($data["otp_code"])) { echo "Code: " . $data["otp_code"] . PHP_EOL; break; } sleep(5);}const orderId = 42;while (true) {const res = await fetch( `https://su-persim.uz/api/v1/otp/${orderId}`, { headers: { "X-API-Key": "supersim_YOUR_API_KEY" } });const data = await res.json();if (data.otp_code) { console.log("Code:", data.otp_code); break;}await new Promise((r) => setTimeout(r, 5000));}Response — 200 OK
{"order_id": 42,"phone_number": "+393791700000","otp_code": "12345","raw_message": "Login code: 12345. Do not give this code to anyone."}Session download
Section titled “Session download”/api/v1/orders/{order_id}/downloadDownload the session and JSON files as a ZIP. Only available for `session` type orders, and only to the buyer. The ZIP is streamed directly with the `Content-Disposition` attachment header.
import requests
resp = requests.get( f"https://su-persim.uz/api/v1/orders/{order_id}/download", headers={"X-API-Key": "supersim_YOUR_API_KEY"},)open(f"order_{order_id}.zip", "wb").write(resp.content)<?php
$ch = curl_init( "https://su-persim.uz/api/v1/orders/{$order_id}/download");curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_HTTPHEADER, [ "X-API-Key: supersim_YOUR_API_KEY",]);$zip = curl_exec($ch);curl_close($ch);
file_put_contents("order_{$order_id}.zip", $zip);const res = await fetch(`https://su-persim.uz/api/v1/orders/${orderId}/download`,{ headers: { "X-API-Key": "supersim_YOUR_API_KEY" } });const blob = await res.blob();const a = document.createElement("a");a.href = URL.createObjectURL(blob);a.download = `order_${orderId}.zip`;a.click();Response — 200 OK (application/zip)
# Binary ZIP archive containing:# order_42_+393791700000.sessionWarranty check
Section titled “Warranty check”/api/v1/orders/{order_id}/validateVerify the purchased account is still valid and authorized. If it fails, the account is marked `invalid` so support can arrange a replacement.
import requests
resp = requests.post( f"https://su-persim.uz/api/v1/orders/{order_id}/validate", headers={"X-API-Key": "supersim_YOUR_API_KEY"},)print(resp.json())<?php
$ch = curl_init( "https://su-persim.uz/api/v1/orders/{$order_id}/validate");curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_POST, true);curl_setopt($ch, CURLOPT_HTTPHEADER, [ "X-API-Key: supersim_YOUR_API_KEY",]);echo curl_exec($ch);curl_close($ch);const res = await fetch(`https://su-persim.uz/api/v1/orders/${orderId}/validate`,{ method: "POST", headers: { "X-API-Key": "supersim_YOUR_API_KEY" } });console.log(await res.json());Response — 200 OK
{"order_id": 42,"valid": true,"phone_number": "+393791700000","account_status": "valid","message": "Account is valid."}Logout
Section titled “Logout”/api/v1/logout/{order_id}Log the store's bot out of the session and delete the server-side session files. Run this after you have successfully logged in, so you become the only active session.
import requests
resp = requests.post( f"https://su-persim.uz/api/v1/logout/{order_id}", headers={"X-API-Key": "supersim_YOUR_API_KEY"},)print(resp.json())<?php
$ch = curl_init( "https://su-persim.uz/api/v1/logout/{$order_id}");curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_POST, true);curl_setopt($ch, CURLOPT_HTTPHEADER, [ "X-API-Key: supersim_YOUR_API_KEY",]);echo curl_exec($ch);curl_close($ch);const res = await fetch(`https://su-persim.uz/api/v1/logout/${orderId}`,{ method: "POST", headers: { "X-API-Key": "supersim_YOUR_API_KEY" } });console.log(await res.json());Response — 200 OK
{ "status": "success", "detail": "Session logged out and cleaned up." }Webhook
Section titled “Webhook”/api/v1/user/webhookSet (or clear) the webhook URL that receives order updates. See the Webhooks page for the payload format. Send {"url": null} to remove it.
import requests
resp = requests.put( "https://su-persim.uz/api/v1/user/webhook", headers={ "X-API-Key": "supersim_YOUR_API_KEY", "Content-Type": "application/json", }, json={"url": "https://your-server.example/hook"},)print(resp.json())<?php
$ch = curl_init("https://su-persim.uz/api/v1/user/webhook");curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "PUT");curl_setopt($ch, CURLOPT_HTTPHEADER, [ "X-API-Key: supersim_YOUR_API_KEY", "Content-Type: application/json",]);curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode([ "url" => "https://your-server.example/hook",]));echo curl_exec($ch);curl_close($ch);const res = await fetch("https://su-persim.uz/api/v1/user/webhook", {method: "PUT",headers: { "Content-Type": "application/json", "X-API-Key": "supersim_YOUR_API_KEY",},body: JSON.stringify({ url: "https://your-server.example/hook" }),});console.log(await res.json());Response — 200 OK
{ "status": "ok", "webhook_url": "https://your-server.example/hook" }