Everything the dashboard does is an API call: buy data, provision eSIMs, rent numbers, send SMS, configure Tele Agent. Built for human developers — and for autonomous AI agents.
No sales call, no human-gated first project: sign in and mint your own API keys. The product endpoints (catalog, checkout, numbers, Tele Agent) are live — everything below works right now.
Sign in with Firebase and mint esk_live_… keys instantly — scoped to a project (production, test, experiment), hash-stored, revocable in one call.
# mint a key curl -X POST \ https://api.esimgomobile.com/api/v1/keys \ -H "Authorization: Bearer $FIREBASE_ID_TOKEN" \ -H "Content-Type: application/json" \ -d '{"name":"ci","project":"test"}'
Every live route documented in one machine-readable file — marked so generators never pretend a route works before it does.
com.esimgomobile.*HTTPS endpoints, per-endpoint HMAC-SHA256 signatures (Stripe-style t=…,v1=…), at-least-once delivery with backoff, dead-lettering and replay. Billing, number provisioning, porting, calls, SMS, key and KYC events.
draft → information_required → pending → completed. The API tells you exactly which fields each country needs before you submit — submission is fail-closed until carrier onboarding completes.
Collect the identity documents carriers require per country. Verification stays honestly pending_verification until a verification vendor is configured — never a fake "verified".
Component states derived live from service configuration — never fabricated uptime percentages.
The product contract below is final for v1 and live on the platform. Authenticate with a bearer API key; every response is JSON.
| Method | Endpoint | What it does |
|---|---|---|
GET | /api/catalog | List live eSIM plans (country, data, validity, price) |
POST | /api/checkout | Create a checkout session for a plan → returns payment URL |
GET | /api/account | Orders, lines, numbers and Tele Agent status |
GET | /api/qr?order_id=… | Fetch or re-issue the eSIM QR / activation code |
GET | /api/balance?profile_id=… | Live remaining data for an eSIM line |
GET | /api/numbers?country=… | Search available virtual numbers |
POST | /api/numbers/purchase | Rent a virtual number (monthly) |
POST | /api/teleagent/signup | Attach Tele Agent to a number with business config |
# list live eSIM plans curl https://esimgomobile.com/api/catalog \ -H "Authorization: Bearer $ESIM_API_KEY" # → { "plans": [ { "id": "esim-jp-10gb-30d", "country": "Japan", # "data_gb": 10, "validity_days": 30, "price_usd": 24.9, ... } ] } # check data balance on a line curl "https://esimgomobile.com/api/balance?profile_id=prof_abc" \ -H "Authorization: Bearer $ESIM_API_KEY" # → { "profile_id": "prof_abc", "remaining_mb": 6240, # "total_mb": 10240, "percent": 61 }
Live: idiomatic JavaScript and Python clients covering every live route — keys, webhooks, porting, KYC, status. Tested, versioned, on GitHub.
Status: liveLive: the esim CLI scripts everything from the terminal — esim keys issue, esim webhooks register, esim portings create, esim kyc verify. Made for automation and agents.
A Model Context Protocol server exposing the whole platform to AI agents — buy data, provision lines, manage numbers and Tele Agent from any MCP client. Already powering our ChatGPT app; the same server ships for Claude and other agents.
Status: in progressBring your Twilio voice/SMS app to esimgomobile without rewriting it: port your numbers, point your webhooks at our compatible endpoints, verify with a test call. A guided toolkit walks the whole move — numbers, messaging and Tele Agent included.
Status: liveSign in, mint an esk_live_… key and start building against the live developer platform — webhooks, porting, KYC and status included.
Using developers in Iran? You are on the local edition — key facts for Iran (capital Tehran, dial code +98) are below. esimgomobile plans for Iran are live now — monthly plans from $8/mo and one-time travel packs from $3.65, with live checkout.
| Capital | Tehran |
|---|---|
| Dial code | +98 |
| Currency | Iranian rial (IRR) |
| Time zone | UTC+3:30 |
| Main languages | Persian |
Plans are live — see plans and pricing.
How it works
Every screen below is the real flow: plans, coverage, speed and support, rendered for this page.
curl https://api.esimgomobile.com/v1/esims \
-H "Authorization: Bearer $KEY" \
-d '{"country":"IR"}'
Explainer
The short version: prepaid travel eSIMs across 195 destinations, installed by QR code in two minutes, managed from a dashboard, with an AI agent on call when you need a human-style answer fast.
Everything on this page exists to answer one question well: how does esimgomobile fit into your trip? The sections below go deep so you never need a second tab.
The long version is the rest of this page — plans, mechanics, edge cases and honest trade-offs, written the way we'd explain it to a friend.
Explainer
Explainer
These are the details that separate a smooth trip from a stressful one — small, unglamorous, and worth more than any feature list.
Explainer
Roaming bills taught a generation to fear their phones abroad. The eSIM generation simply never learned that fear — data is prepaid, visible and finite.
And because everything is prepaid through Amazon Pay, the commercial relationship is simple: you pay for data, you get data, it ends when it ends.
The Tele Agent closes the remaining gap: a question at midnight in a foreign terminal gets an answer in seconds, not a support ticket.
Visual guides
esimgomobile Developers — data dashboard
The product's headline numbers, switchable by dataset.
Hover any bar or point for its exact value. Tabs switch datasets — everything on this panel is computed from live product data unless labeled illustrative.
Prepaid, no contracts, no roaming surprises. The whole setup takes about two minutes.