>
Documentation

Learn it once. Connect everywhere.

Guides and references for eSIM plans, virtual numbers, Tele Agent and the API. Every guide below works against the live network — no waiting list, no gated steps.

Start here

Quickstarts

Three paths from zero to connected — every step works against the live network.

Buy your first eSIM

  1. Create your account — pick a plan, live now.
  2. Pick a plan and check out — live now.
  3. Scan the QR code to install the eSIM.

Set up a team plan

  1. Create your account — pick a plan, live now.
  2. Create your workspace and invite the team.
  3. Assign numbers and data pools per line.

Build on the developer API

  1. Mint a developer API key (self-serve) — live now.
  2. Read the OpenAPI 3.1 document — live now.
  3. Subscribe to com.esimgomobile.* webhooks for billing, porting, number and call events — live now.
  4. Automate top-ups per line.
For builders

Developer platform — live today

Self-serve API keys, a published OpenAPI 3.1 document, JavaScript and Python SDKs, a CLI, com.esimgomobile.* webhooks, a number-porting API, KYC intake and an honest status page. The product API contract (catalog, checkout, account, QR, balance, numbers, Tele Agent) is live — and so is the developer platform.

Build on the API System status

History

What shipped

Every public change to esimgomobile, newest first — dated, in English, nothing invented.

Read the changelog

Keep exploring

More resources

esimgomobile in Iran

Using docs 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.

CapitalTehran
Dial code+98
CurrencyIranian rial (IRR)
Time zoneUTC+3:30
Main languagesPersian

Plans are live — see plans and pricing.

The experience

The product, up close.

Twenty product screens and twenty field photos — this is what traveling connected looks like.

girl using mobile phone
Get connected
1 Pick a plan2 Scan QR3 Land online
Three steps on Docs · Iran: pick a plan, scan the QR, land online.
  1. 1A real traveler quote, tied to the destination it mentions.
  2. 2Reviews reference actual trips, not generic praise.
eSIM installedYour Iran plan is ready.
Push · just now
Push notification on Docs · Iran: eSIM installed, plan ready to activate.
  1. 1A real traveler quote, tied to the destination it mentions.
  2. 2Reviews reference actual trips, not generic praise.
Tele Agent
“Setting up your Iran line…”
AI voice agent on Docs · Iran — answers spoken aloud, never a support ticket.
  1. 1The plan card shows exactly what you're buying — data, days, destination.
  2. 2One tap starts the two-minute QR install.
esimgomobile.com
Plans for Iran
Atlas 5GB5 GB · 30 days
Atlas 20GB20 GB · 30 days
Atlas 50GB50 GB · 60 days
Compare plans
Plan picker on Docs · Iran: 5GB, 20GB, 50GB and Unlimited — pick by trip, not fine print.
  1. 1The dashboard keeps every eSIM, every trip, in one place.
  2. 2Rows show data left, days left and current city at a glance.
people on a video call
Iran is calling.
Get your eSIM
Live now · no waitlist
“Iran is calling.” — the CTA card on Docs · Iran: plans live now, no waitlist.
  1. 1Coverage status at a glance: data live, number available, 5G ready.
  2. 2Green means go — no guessing about what's supported.
Support
How does Docs · Iran work?
Enter your trip details and get an instant answer — no account needed.
Support snippet — Docs · Iran: what it does, in one honest answer.
  1. 1Coverage status at a glance: data live, number available, 5G ready.
  2. 2Green means go — no guessing about what's supported.
79%
data left
Usage ring on Docs · Iran — 79% of data left: the number travelers check most.
  1. 1Usage ring compresses the whole plan into one glanceable number.
  2. 2Percent remaining is the only metric most travelers check.
vs roaming
esimgomobile eSIMone price
Carrier roamingper-day fees
10 GB · 14 days · Iran
The honest comparison on Docs · Iran: one prepaid eSIM price versus carrier roaming.
  1. 1The roaming math, made visible: one price versus per-day carrier fees.
  2. 2This is the comparison most travelers never see until the bill.
Recent speeds
Paris683 Mbps
Rome360 Mbps
Rio de Janeiro351 Mbps
Recent speeds for Docs · Iran — Paris, Rome, Rio de Janeiro: illustrative 5G figures, not live measurements.
  1. 1Mockups illustrate the product flow — captions describe what's real.
  2. 2Figures labeled as examples show sample data, never live telemetry.
esimgomobile.com
API quickstart
curl https://api.esimgomobile.com/v1/esims \
  -H "Authorization: Bearer $KEY" \
  -d '{"country":"IR"}'
200 OK · 68 ms
REST API behind Docs · Iran: issue eSIMs programmatically — 200 OK in milliseconds.
  1. 1The dashboard keeps every eSIM, every trip, in one place.
  2. 2Rows show data left, days left and current city at a glance.
Pok Rie
Pack light. Stay connected in Iran.
Get your eSIM
“Pack light. Stay connected in Iran.” — the banner on Docs · Iran: two minutes from curious to connected.
  1. 1Coverage pins show where partner networks are live.
  2. 2The map answers the only question that matters: will it work there?
Install
1 Scan2 Add3 Go
The Docs · Iran install: QR in three steps — scan, add, go, about two minutes.
  1. 1The Tele Agent answers in plain language — no telecom jargon.
  2. 2Every answer is specific to your trip, not a generic FAQ.
Iran · 5G
Signal widget on Docs · Iran: network generation and place, always visible.
  1. 1Usage ring compresses the whole plan into one glanceable number.
  2. 2Percent remaining is the only metric most travelers check.
Atlas Unlimited
Unlimited · 30 days
Iran
Atlas Unlimited — Unlimited · 30 days, prepaid and ready on Docs · Iran.
  1. 1Signal widget: network generation and destination, always visible.
  2. 2Five bars, zero ambiguity about what you're connected to.
esimgomobile.com
Checkout
Atlas 5GB — Irantotal
Taxescalculated
Pay securely
256-bit encrypted · Amazon Pay
Secure checkout on Docs · Iran: Atlas 5GB, full price up front, no fine print.
  1. 1Checkout shows the full price before you pay. Nothing hidden.
  2. 2Amazon Pay handles payment securely; taxes are calculated for you.
$8
entry monthly plan
launch fact
Launch fact behind Docs · Iran: $8 entry monthly plan — a fixed figure, not live telemetry.
  1. 1A real traveler quote, tied to the destination it mentions.
  2. 2Reviews reference actual trips, not generic praise.
Coverage
195
destinations live
Iran5G ready
Check coverage
Coverage at a glance for Docs · Iran: 195 destinations live, fastest local partner selected on its own.
  1. 1The Tele Agent answers in plain language — no telecom jargon.
  2. 2Every answer is specific to your trip, not a generic FAQ.
eSIM plan
Atlas UnlimitedUnlimited · 30 days
Iran
Install eSIM
Atlas Unlimited on Docs · Iran — Unlimited · 30 days, prepaid with the full price shown before you pay.
  1. 1The plan card shows exactly what you're buying — data, days, destination.
  2. 2One tap starts the two-minute QR install.
Speed test
281Mbps
5G · Iran · 21 ms
Illustrative speed readout on Docs · Iran: 281 Mbps, 21 ms — example figures, not live measurements.
  1. 1The Tele Agent answers in plain language — no telecom jargon.
  2. 2Every answer is specific to your trip, not a generic FAQ.
Language
EnglishPortuguêsEspañol
Language picker on Docs · Iran — English, Português, Español: the app speaks six languages.
  1. 1The plan chip: name, allowance and destination in one line.
  2. 2Everything you need to confirm you're on the right plan.
Senior tourists photographing scenic landscape in Cappadocia, Türkiye under a sun umbrella on a sunny day. — Docs · Iran: The docs are versioned — what you read matches what you run.
Docs · Iran: The docs are versioned — what you read matches what you run.
eiffel tower and building — Docs · Iran: API references with copy-paste curl — the docs respect your time.
Docs · Iran: API references with copy-paste curl — the docs respect your time.
a woman sitting with a laptop — Docs · Iran: The modern arrival: online before the seatbelt sign goes off.
Docs · Iran: The modern arrival: online before the seatbelt sign goes off.
Alexey Chudin — Docs · Iran: Sunrise hikes start with a weather check — data on, boots on.
Docs · Iran: Sunrise hikes start with a weather check — data on, boots on.
woman standing in front of a laptop — Docs · Iran: The group chat stays live across every border you cross.
Docs · Iran: The group chat stays live across every border you cross.
Tolga Utangan — Docs · Iran: Night markets and late trains — connected the whole way through.
Docs · Iran: Night markets and late trains — connected the whole way through.
Taryn Elliott — Docs · Iran: Rain or shine, the connection holds — weather doesn't throttle data.
Docs · Iran: Rain or shine, the connection holds — weather doesn't throttle data.
a man having a video call on his laptop — Docs · Iran: The business trip: client deck synced, video call joined from the taxi.
Docs · Iran: The business trip: client deck synced, video call joined from the taxi.
mother and daughter walking at eindhoven airport — Docs · Iran: The connected trip: maps, messages and translation, all on one eSIM.
Docs · Iran: The connected trip: maps, messages and translation, all on one eSIM.
breathtaking santorini sunset over the aegean sea — Docs · Iran: Rainy-day backup plan: indoor attractions researched from the hostel bunk.
Docs · Iran: Rainy-day backup plan: indoor attractions researched from the hostel bunk.
eiffel tower in paris framed by lush greenery — Docs · Iran: Street-food stalls and mobile pay: dinner ordered without a word of the language.
Docs · Iran: Street-food stalls and mobile pay: dinner ordered without a word of the language.
man standing with mountains behind — Docs · Iran: The docs assume you're at an airport — short, scannable, correct.
Docs · Iran: The docs assume you're at an airport — short, scannable, correct.
view of brown and grey high rise building — Docs · Iran: The sunrise ferry: tickets in the wallet app, timetable cached offline.
Docs · Iran: The sunrise ferry: tickets in the wallet app, timetable cached offline.
Franco Monsalvo — Docs · Iran: Family group chat: location shared, dinner plans settled in minutes.
Docs · Iran: Family group chat: location shared, dinner plans settled in minutes.
Man photographing urban cityscape with smartphone against skyline. — Docs · Iran: The long layover: streaming, working and messaging, all covered.
Docs · Iran: The long layover: streaming, working and messaging, all covered.
woman in brown t shirt pushing her pink luggage and man in black long sleeves pushing trolley — Docs · Iran: City lights after dark — the eSIM doesn't care what time it is.
Docs · Iran: City lights after dark — the eSIM doesn't care what time it is.
night street scene in tokyo s urban landscape — Docs · Iran: Harbor views with full bars: coverage where travelers actually go.
Docs · Iran: Harbor views with full bars: coverage where travelers actually go.
low angle shot of the eiffel tower against blue sky — Docs · Iran: The conference badge: QR ticket scanned, session schedule synced.
Docs · Iran: The conference badge: QR ticket scanned, session schedule synced.
Josh Sorenson — Docs · Iran: Street level: navigation, rideshares and reviews, all instant.
Docs · Iran: Street level: navigation, rideshares and reviews, all instant.
a blue wooden door on a white concrete wall — Docs · Iran: Coast roads and country lanes — the map keeps up wherever you roam.
Docs · Iran: Coast roads and country lanes — the map keeps up wherever you roam.

Explainer

Docs: the full picture

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.

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.

Explainer

How it works, step by step

  1. Buy before you fly
    • Order from home, the hotel, or the departure lounge — delivery is instant and digital.
    • No shipping, no pickup counters, no airport SIM queues.
  2. Add the eSIM
    • One QR scan adds the plan to your phone. iPhone and Android both walk you through it in under a minute.
    • You can install now and activate later — the plan starts when you choose.
  3. Stay online abroad
    • Data, maps, translation and messaging work the moment you land.
    • Running low? Top up in one tap from your dashboard — no new QR code needed.

Explainer

Good to know

  • Check that your phone is carrier-unlocked before you buy any eSIM — locked phones can't add one.
  • Screenshot your hotel address and booking confirmations — you'll want them with no signal.
  • If a page won't load, toggle airplane mode for ten seconds — it forces a fresh network attach.
  • Turn off auto-play on social apps before you fly; it quietly eats roaming data.
  • Download offline maps for your destination — they save data and work in dead zones.
  • Set a data alert at 80% so a top-up never surprises you mid-trip.

These are the details that separate a smooth trip from a stressful one — small, unglamorous, and worth more than any feature list.

Explainer

Why travelers switch

The Tele Agent closes the remaining gap: a question at midnight in a foreign terminal gets an answer in seconds, not a support ticket.

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.

Charts & explainers

Every chart that matters for Iran.

Docs — data dashboard

The product's headline numbers, switchable by dataset.

195
destinations live
global footprint
4
Atlas plans
prepaid, no contracts
~2 min
typical install
QR scan to online
6
app languages
EN ES FR DE PT JA
Atlas 5GB: 5 GB over 30 days — Weekend breaks & light useAtlas 5GB 5 GBAtlas 20GB: 20 GB over 30 days — Two-week trips & daily useAtlas 20GB 20 GBAtlas 50GB: 50 GB over 60 days — Remote work & hotspottingAtlas 50GB 50 GBAtlas Unlimited: Unlimited over 30 days — Heavy use, zero meteringAtlas Unlimited Unlimited
Atlas 5GB: 30-day validityAtlas 5GB 30 daysAtlas 20GB: 30-day validityAtlas 20GB 30 daysAtlas 50GB: 60-day validityAtlas 50GB 60 daysAtlas Unlimited: 30-day validityAtlas Unlimited 30 days
Illustrative — D1: 100% of maxIllustrative — D10: 70% of maxIllustrative — D20: 42% of maxIllustrative — D30: 12% of maxDay 1Day 10Day 20Day 30IllustrativeIllustrative 20 GB burn-down at moderate use.

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.

Docs — data dashboard. Plan allowances, validity windows and a typical usage curve for Docs — hover for exact values.
Questions, answeredThe six things everyone asks firstQuestions, answeredShort answers, no sales pitch.Which phones work?
Any carrier-unlocked, eSIM-capable iPhone or Android.
How fast is setup?
About two minutes: plan, QR scan, done.
Does hotspot work?
Yes — share your connection with laptop or tablet.
What if data runs out?
80% alert, then one-tap top-up. No bill shock.
Do I keep my number?
Yes — WhatsApp & iMessage keep working on your existing number.
Is it a contract?
No — prepaid. Service simply stops instead of charging extra.
FAQ at a glance. Short answers, no sales pitch — the questions first, always.
Every plan includesNo tiers of basic dignity — these ship with all plansEvery plan includesThe baseline is generous on purpose.6 languagesThe app speaks your language, wherever you're from.One-tap top-upMore data in seconds — no new QR code.Keep your WhatsAppYour existing number keeps working on the data line.Hotspot includedShare with your laptop or tablet at no extra cost.5G where availableFastest local partner network, selected automatically.24/7 supportReal humans plus the Tele Agent, around the clock.
Included with every plan. 5G, hotspot, WhatsApp continuity, top-up, support, six languages — all tiers.
What your gigabytes meanTypical hourly usage per activityWhat your gigabytes meanTranslate plan sizes into real travel behavior.Maps & navigation≈ 5 MB / hourMessaging & email≈ 20 MB / hourSocial browsing≈ 150 MB / hourVideo calls≈ 600 MB / hourHD streaming≈ 1.5 GB / hourTypical usage rates — actual consumption varies by app and quality settings.
Data usage guide. A 20 GB plan covers roughly two weeks of normal travel use.
Get connected in three stepsFrom purchase to online in about two minutesGet connected in three stepsNo store visit, no plastic SIM, no waiting for the post.1Scan the QR codeThe eSIM installs straight onto your phone. No store, no plastic SIM.2Pick your planChoose data for your trip — checkout takes about two minutes.3Land connectedSwitch the line on when you arrive — online before baggage claim.
Three-step setup. Buy, scan, land: the whole sequence fits in a coffee queue.
Plan comparison matrixEvery plan for Iran — data, validity, best fitPlans at a glanceFour prepaid plans cover every kind of trip to Iran.PLANDATAVALIDITYAtlas 5GBWeekend breaks & light use5 GB30 daysAtlas 20GBTwo-week trips & daily use20 GB30 daysAtlas 50GBRemote work & hotspotting50 GB60 daysAtlas UnlimitedHeavy use, zero meteringUnlimited30 days
Plan comparison matrix. Weekend sips, fortnight data, work-month gulps, or unlimited — pick by trip shape.
Network at a glanceCoverage facts for IranNetwork at a glanceThe numbers that matter before you buy.195destinations liveesimgomobile network data5Gwhere available in Iranesimgomobile network data6app languagesesimgomobile network data2 mintypical install timeesimgomobile network dataPlus: local numbers where available, hotspot included, 24/7 support.Prepaid only — when the plan ends, it simply stops. No contracts.
Coverage facts. The network resume for Docs · Iran: 195 destinations, 5G where available, six languages.
Pro tipsFour habits of the always-connectedPro tipsSmall habits, big difference.1Screenshot bookingsHotel address & confirmations, available with no signal.2Download offline mapsThey save data and work in dead zones.3Keep home SIM for 2FABank codes still arrive while data runs on the eSIM.4Install before you flyAirport Wi-Fi is the worst place to set up connectivity.
Pro tips. Veterans do all four without thinking.
Docs: capability profileWhat the tool is good at — illustrative profileCapability profileFive strengths, ranked by what users feel first.Shares wellsend the answer to travel companionsAlways currentreflects live plans and coverageInstant resultsno waiting, no signupPrivate by designyour inputs stay in your browserMobile friendlyworks on the phone in your handIllustrative profile based on tool design — not measured telemetry.
Capability profile. What Docs · Iran does best — the capability profile, honestly ranked.
Who it's forFour travelers, one toolWho it's forBuilt for real trip shapes, not personas.1The remote worker
Size data for video calls and hotspotting with confidence.
esimgomobile network data2The last-minute flyer
Answer in minutes, eSIM installed before boarding.
esimgomobile network data3The planner
Compare before you commit — know the right plan weeks ahead.
esimgomobile network data4The family organizer
One tool, every traveler's needs covered.
esimgomobile network data
Use cases. Six traveler shapes, one tool — Docs · Iran's use cases.
How Docs worksFour steps from question to answerHow this tool worksBuilt to answer one question well.1Open the toolNo account needed — it loads instantly in your browser.2Get the answerClear result with next steps — save it or act on it.3Enter your detailsTrip, data needs, destination. The tool does the math.4Apply itJump straight to the plan, setting or page it points to.
Tool walkthrough. Every tool on esimgomobile follows the same honest pattern: input, math, answer.

Start your Iran trip online

Pick a plan, check out securely, scan the QR code — you're online before you land.

See plans and pricing Talk to the Tele Agent