Skip to content

Endpoints

GET/api/v1/stock

List all active countries with prices and available stock. This is the only endpoint that does not require authentication.

GET /api/v1/stock
import requests
resp = requests.get(
"https://su-persim.uz/api/v1/stock",
)
print(resp.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
}
]
GET/api/v1/orders?page=1&per_page=20

Paginated list of your orders with their current status. Status is one of `paid`, `otp_ready`, or `completed`.

GET /api/v1/orders?page=1&per_page=20
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())

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"
}
]
}
GET/api/v1/orders/{order_id}

Full details for a single order, including OTP readiness, download availability, and the 2FA password.

GET /api/v1/orders/{order_id}
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())

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
}
GET/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.

GET /api/v1/otp/{order_id}
import time
import requests
order_id = 42
while 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)

Response — 200 OK

{
"order_id": 42,
"phone_number": "+393791700000",
"otp_code": "12345",
"raw_message": "Login code: 12345. Do not give this code to anyone."
}
GET/api/v1/orders/{order_id}/download

Download 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.

GET /api/v1/orders/{order_id}/download
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)

Response — 200 OK (application/zip)

order_42_+393791700000.json
# Binary ZIP archive containing:
# order_42_+393791700000.session
POST/api/v1/orders/{order_id}/validate

Verify the purchased account is still valid and authorized. If it fails, the account is marked `invalid` so support can arrange a replacement.

POST /api/v1/orders/{order_id}/validate
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())

Response — 200 OK

{
"order_id": 42,
"valid": true,
"phone_number": "+393791700000",
"account_status": "valid",
"message": "Account is valid."
}
POST/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.

POST /api/v1/logout/{order_id}
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())

Response — 200 OK

{ "status": "success", "detail": "Session logged out and cleaned up." }
PUT/api/v1/user/webhook

Set (or clear) the webhook URL that receives order updates. See the Webhooks page for the payload format. Send {"url": null} to remove it.

PUT /api/v1/user/webhook
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())

Response — 200 OK

{ "status": "ok", "webhook_url": "https://your-server.example/hook" }