One key, two products
The same nv_live_ key orders virtual numbers for OTP and travel eSIM. No second integration, no second account.
eSIM API
Sell travel eSIM from your own app — same API key as virtual numbers
NumVersal exposes one plain JSON API for both products. Check balance, order an OTP number or an eSIM package, read the code, top up — all with a single key and a single balance.
Why one API
One shared balance
Top up once with QRIS or PayPal — numbers and eSIM are charged from the same wallet, and failed eSIM orders are refunded automatically.
Delivery in seconds
Orders are pushed to the provider immediately; poll the order until the activation code (LPA string) is filled in.
Live catalog
Pull the full eSIM catalog with your own selling price per SKU, filtered by destination whenever you need it.
Safe by default
Keys are hashed, shown once and revocable at any time. Call the API from your server, never from a browser.
40+ destinations
Regional and country packages for travellers, kept in sync with the upstream catalog by our admin panel.
Three calls to a live eSIM
# 1. list eSIM packages for a destination
curl "https://numversal.com/api/public/v1/esim/products?destination=japan" \
-H "Authorization: Bearer nv_live_xxxxxxxxxxxx"
# 2. order one
curl -X POST https://numversal.com/api/public/v1/esim/orders \
-H "Authorization: Bearer nv_live_xxxxxxxxxxxx" \
-H "Content-Type: application/json" \
-d '{"sku":"ESIMJP5","customer_no":"you@example.com"}'
# 3. poll until the activation code arrives
curl https://numversal.com/api/public/v1/esim/orders/<id> \
-H "Authorization: Bearer nv_live_xxxxxxxxxxxx"Every endpoint, field and error code is documented in the API documentation, together with the virtual number, balance and top up endpoints.
Getting started
- 1
Create a free account and top up your balance.
- 2
Generate an API key in the dashboard under API access.
- 3
Call GET /esim/products to load the catalog with your prices.
- 4
POST /esim/orders and poll the order for the activation code.