Skip to content

Getting Started

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

  2. Point your code at the base URL

    All requests go to the same base URL:

    https://su-persim.uz/api/v1

    The store API is RESTful and returns JSON. Every endpoint except GET /stock requires the X-API-Key header.

  3. Make your first request

    Check the live stock and prices before buying:

    GET /api/v1/stock
    import requests
    resp = 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"
    )
  4. Complete your first purchase

    Buying is a single call. Pass an optional Idempotency-Key header so a retried request never charges you twice:

    POST /api/v1/buy
    import requests
    resp = 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())

    The response includes your order_id, the account’s phone number, and its 2FA password.

  5. Fetch the OTP and finalize

    1. GET /api/v1/otp/{order_id} — wait for the login code.
    2. Log in to Telegram with the phone + password + OTP.
    3. POST /api/v1/logout/{order_id} — logs the bot out of the session so you are the only active session.