Skip to content

Supersim API

API v1 — stable

Build on Supersim.

The complete developer documentation for integrating the Supersim store into your applications. Fast, reliable, and scalable — with official examples in Python, PHP and JavaScript.

🧩

Three-Language Support

Ready-to-copy examples for Python, PHP, and JavaScript — every endpoint, every request.

🛡️

Secure by Default

Hashed API keys, per-key rate limiting, idempotent purchases, and ownership checks on every order.

🔗

Webhooks & Automation

Receive OTP and order updates in real time on your own endpoint — no polling required.

Every request authenticates with your API key in the X-API-Key header. Here is how you check the live stock:

GET /api/v1/stock
import requests
resp = requests.get(
"https://su-persim.uz/api/v1/stock",
headers={"X-API-Key": "supersim_YOUR_API_KEY"},
)
print(resp.status_code)
print(resp.json())

Get your API key from the Telegram bot, then read the Getting Started guide.