eSIM API

eSIM API for partners: catalogue, orders, status and webhooks with a sandbox and a 99.9% availability target

Issue travel eSIMs for 195+ countries, student SIMs and IoT SIMs from your own product. REST and JSON, sandbox in 2 working days, integration in 2 to 4 weeks, wholesale 30% to 45% below retail.

Request sandbox access White label store instead

API at a glance

Style REST, JSON, Bearer API keys

Endpoints Catalogue, orders, eSIM status, top-up, wallet, webhooks

Sandbox Full mirror with test profiles and simulated activation

Fulfilment QR and LPA string in under 60 seconds

Availability target 99.9% monthly, public status page

Rate limit 600 requests a minute per key

Pricing Wholesale 30% to 45% below retail, no API fee

The Universal eSIMs API lets partners list plans for 195+ countries, create orders that return a QR code and LPA string in under 60 seconds, read eSIM status and data usage, add top-ups and receive 8 webhook events. It has a full sandbox, a 99.9% availability target, no API fee and wholesale pricing 30% to 45% below retail.

Partner terms published on 25 October 2026 · Competitor terms observed October 2026 · No joining fee for affiliates and resellers during launch

Who the API suits

Travel platforms

OTAs, airlines, tour operators and travel super-apps that already know the destination and date and want to add an eSIM at checkout or in the pre-trip flow.

Fintech

Banks, neobanks and forex-card issuers that want to issue an eSIM when a card is loaded or a trip is detected.

Device and IoT builders

Hardware makers and logistics platforms that need SIM lifecycle control for trackers, POS terminals and sensors. See IoT SIM.

Endpoints

Partner API endpoints (v1)

Endpoint What it does Scope GET /v1/catalogue List countries, regions and plans with data, validity, networks, retail price and your wholesale price catalogue:read GET /v1/catalogue/{country} Plans for one country or region code, for example TH or EU catalogue:read POST /v1/orders Create an order for a plan; returns order ID, ICCID, QR image URL and LPA activation string orders:write GET /v1/orders/{id} Order status, fulfilment time and delivery channel orders:read GET /v1/esims/{iccid} eSIM status: issued, installed, activated, expired; data used and remaining; validity dates esims:read POST /v1/esims/{iccid}/topup Add a top-up plan to an existing eSIM without a new QR code orders:write GET /v1/wallet Prepaid balance, low-balance threshold and recent transactions wallet:read POST /v1/webhooks Register an HTTPS endpoint for order and eSIM events; HMAC-signed payloads webhooks:write POST /v1/sandbox/esims/{iccid}/activate Sandbox only: simulate installation and first connection to test your webhooks sandbox

Webhook events

Event Fires when order.created Order accepted and wallet debited order.fulfilled eSIM profile allocated; QR and LPA string available esim.installed Profile downloaded to a device esim.activated First connection in the destination; validity starts esim.data_80 Customer has used 80% of plan data; good moment to offer a top-up esim.expired Validity ended or data exhausted topup.applied Top-up added to the eSIM wallet.low Balance below your threshold

Example: create an order in the sandbox

curl -X POST https://sandbox-api.universalesims.com/v1/orders \
-H "Authorization: Bearer sk_test_your_sandbox_key" \
-H "Idempotency-Key: booking-48213-esim" \
-H "Content-Type: application/json" \
-d '{
"plan_id": "esim-thailand-5gb-30d",
"customer": { "email": "traveller@example.com", "whatsapp": "+919800000000" },
"delivery": ["email", "whatsapp"],
"reference": "booking-48213"
}'

# 201 Created
{
"id": "ord_01HZX5K9Q2",
"status": "fulfilled",
"plan_id": "esim-thailand-5gb-30d",
"retail_price": { "amount": 649, "currency": "INR" },
"wholesale_price": { "amount": 422, "currency": "INR" },
"esim": {
"iccid": "8991000012345678901",
"lpa": "LPA:1$rsp.example.net$ABCDEF-123456",
"qr_url": "https://api.universalesims.com/v1/esims/8991000012345678901/qr.png",
"status": "issued"
},
"created_at": "2026-10-25T09:14:03Z"
}

Plan IDs follow the pattern esim-{country}-{data}-{validity}. Wholesale prices in responses reflect your band. Sandbox orders never debit a real wallet.

Sandbox

Sandbox details

Item Detail Base URL https://sandbox-api.universalesims.com Keys sk_test_ prefix, issued within 2 working days of applying Test profiles Return valid-looking ICCID, LPA string and QR; do not connect to networks Simulated lifecycle POST /v1/sandbox/esims/{iccid}/activate moves an eSIM through installed and activated and fires the webhooks Wallet Preloaded test balance of ₹1,00,000, reset on request Promotion to production Same endpoints, swap the base URL and the key after a 20-minute go-live review

Commercial terms

API commercial terms

Term Value API fee None Plan pricing Wholesale, indicatively 30% to 45% below retail by committed monthly volume Alternative Revenue share from 20% at our retail price Settlement Prepaid wallet with low-balance webhook, or monthly invoice for approved accounts Availability 99.9% monthly target with service credits Support Named integration engineer during build; shared channel and status page after launch Integration time 2 to 4 weeks typical Minimum commitment None at band 1; higher bands require a monthly volume commitment

How to integrate

Apply for sandbox access

Use the partner form and choose "White label or API". Tell us the use case and expected monthly volume.

Scoping call and keys in 2 working days

A 30-minute call confirms the flow, then sandbox keys, the full reference docs and a Postman collection arrive by email.

Build against the sandbox

Catalogue, orders, status and webhooks, with simulated activation to test the whole lifecycle. Your integration engineer reviews the flow before go-live.

Go live

Production keys after a 20-minute review, wallet funded or settlement agreed, status page and shared support channel open.

API terms compared with other providers

Partner programme terms published by each company, observed October 2026

Company Affiliate Reseller Franchise API and white label Payout Universal eSIMs 15% first order, 5% repeat for 12 months, 45-day cookie 25% to 35% margin, published 35% to 40% plus 5% override, published Public overview, sandbox, wholesale 30% to 45% below retail Monthly; ₹1,000 or US$25 minimum TSIM 10%, 1-year attribution Not published Not published Not published ₹1,000 threshold eSIMify 8% of net order, 30-day cookie Not published Not published Not published Not published on terms page Matrix Programme exists, no percentage published Programme exists, no terms published Not published On request Not published PingSIM Portal exists, no percentage published Not published Not published Public docs, no commercial terms Not published Simify Via a network, no percentage published Not published Not published Not published Not published Onomondo Not offered Tiered programme, no numbers Not published Public docs, quote-only pricing n/a 1GLOBAL Enquiry only Enquiry only Not published Enquiry only Not published

Competitor terms are what each company published on its own website when we checked in October 2026. "Not published" means the company describes a programme but gives no numbers. Terms change; check the source before relying on them.

eSIM API questions

Is the Universal eSIMs API public?

The overview, endpoint list, event list and commercial terms are public on this page. Full reference documentation and keys are issued after a short scoping call, because the API issues real eSIMs against a prepaid wallet. Sandbox keys are issued within 2 working days of applying.

How does the sandbox work?

The sandbox at sandbox-api.universalesims.com mirrors production endpoints with test keys prefixed sk_test_. Orders return test eSIM profiles that do not connect to any network. A sandbox-only endpoint simulates installation and activation so you can test every webhook event end to end without spending money.

What does the API cost?

There is no API fee. You pay for plans at wholesale, indicatively 30% to 45% below retail depending on committed monthly volume, from a prepaid wallet or on monthly settlement for approved accounts. Revenue share from 20% is available if you prefer to sell at our retail price.

How are webhooks secured?

Each payload is signed with an HMAC-SHA256 signature in the X-UE-Signature header using your webhook secret, includes a timestamp to prevent replay, and is retried with exponential backoff for 24 hours until your endpoint returns a 2xx.

What is the availability target?

99.9% monthly API availability, measured on the order and status endpoints, with a public status page, incident reports within 48 hours and service credits in the agreement. eSIM fulfilment is under 60 seconds in normal operation.

Can I get the QR as an image and as a string?

Yes. Every fulfilled order returns a hosted QR PNG URL and the raw LPA activation string, so you can render the QR yourself, deep-link iOS 17.4+ universal eSIM installation, or send it by your own email or WhatsApp channel.

Does the API cover student SIMs and IoT SIMs?

Student SIM kits are in the catalogue with a local-number flag and a continuation plan ID. IoT SIMs use the same order endpoint for IoT Go plans; IoT Scale and Enterprise accounts get the IoT management API with SIM lifecycle controls, which is documented separately.

What are the rate limits?

600 requests a minute per key by default, with burst allowance, and higher limits on request. Idempotency keys on POST requests make retries safe for 24 hours.

How does this compare with other eSIM APIs?

As observed in October 2026, PingSIM and Onomondo publish API documentation and Matrix, Maya Mobile and 1GLOBAL provide APIs on request or under NDA. None of them publishes wholesale pricing alongside the API. Universal eSIMs publishes the endpoint list, sandbox details, wholesale range, revenue share floor and SLA target here.

• Request sandbox access
· • White label eSIM store
· • Reseller programme
· • All partner programmes
· • Travel eSIM destinations
· • Student SIM
· • IoT SIM
· • IoT pricing
· • Contact us

Sandbox keys in 2 working days

No API fee, no minimum at band 1, and an engineer on your side until go-live.

Request sandbox access Ask a technical question

Universal eSIMs partner API

REST API for issuing travel eSIMs, student SIMs and IoT SIMs with sandbox, webhooks and a 99.9% availability target.

Service Type: Partner programme

Currency: INR