eSimfly Logo
ESIM API & WHOLESALE

eSIM API for Developers: Sell eSIMs in Your Own Product

Integrate wholesale eSIM data plans for 200 countries into your app, platform, or store through one REST API — catalog, ordering, top-ups, usage, and full lifecycle management.

Who Builds on the eSIM API

Companies use wholesale eSIM integration to add connectivity revenue to their existing product.

Travel Apps & OTAs

Offer an eSIM upsell at booking time. Your travelers land connected, and you keep the margin on every plan sold.

Resellers & MVNOs

Source eSIMs at wholesale rates and sell through your own channels, with your own pricing and packaging.

IoT & Fleet Platforms

Provision and monitor connectivity for devices and vehicles across borders from a single integration.

Superapps & Fintech

Add international data plans as a native feature next to payments, banking, or loyalty products.

API CAPABILITIES

Everything You Need to Run eSIMs Programmatically

The API covers the full journey from browsing wholesale packages to managing live eSIMs in the field.

Catalog & Pricing

Browse every available data package with wholesale pricing for 200 countries, and check your account balance before ordering.

Get All PackagesBalance Query

Orders & Top-ups

Provision new eSIMs instantly and top up existing ones. Orders return QR codes and activation details ready to deliver to your users.

Create OrderTopup Packages & Orders

eSIM Lifecycle

Manage every eSIM you have issued: check status and data usage, suspend or cancel lines, review network events, and send SMS.

List / Query eSIMseSIM StatusCancel / Suspend / ActivateUsage ReportNetwork EventsSend SMS

Webhooks

Register endpoints to receive real-time notifications for order and eSIM lifecycle events — no polling required.

Webhook ManagementEvent Notifications

Wholesale eSIM Rates, Your Margin

API partners buy data packages at wholesale pricing and set their own retail prices. The catalog spans local, regional, and global plans across 200 countries and 450+ networks, so a single integration covers every destination your users travel to. Balance-based billing keeps settlement simple: fund your account, and each order draws from it at your wholesale rate.

If you want a complete storefront instead of building your own, our white-label eSIM platform ships a branded website, dashboard, and mobile apps on top of the same infrastructure.

Secure by Design: HMAC-Signed Requests

Every API call is authenticated with an HMAC-SHA256 signature over the request timestamp, a unique request ID, your access code, and the request body — providing integrity verification and replay-attack protection. Ready-made signing examples for Node.js, Python, and PHP are in the documentation.

POST /api/v1/business/orders HTTP/1.1
Host: esimfly.net
Content-Type: application/json
RT-AccessCode: your-access-code
RT-RequestID: 6f1c2e4a-...        # unique UUID v4
RT-Timestamp: 1752403200000       # ms since epoch
RT-Signature: A3F0...             # HMAC-SHA256, see docs

{ "package_code": "...", "quantity": 1 }

Get API Access in Three Steps

1. Create a business account

Sign up for an eSIMfly business account and tell us about your use case and expected volume.

2. Generate your API keys

Create and manage access credentials from the business dashboard, then fund your balance.

3. Integrate and launch

Follow the documentation to browse packages, place a test order, and register webhooks for live events.

FAQ

eSIM API Questions, Answered

What is the eSIMfly eSIM API?+

The eSIMfly API is a REST API that lets you buy, provision, and manage eSIMs programmatically at wholesale rates. You can browse the package catalog, create orders, top up plans, monitor usage, and manage the full eSIM lifecycle (activate, suspend, cancel) from your own application, with coverage in 200 countries across 450+ networks.

Who is the eSIM API for?+

The API is built for companies that want to embed eSIM connectivity into their own product: travel apps and booking platforms, telecom resellers and MVNOs, IoT and fleet platforms, and any service that wants to offer international data to its users without building carrier relationships.

How does API authentication work?+

Requests are authenticated with HMAC-SHA256 signatures. Each request carries an access code, a unique request ID, a timestamp, and a signature computed with your secret key, which provides request integrity verification and prevents replay attacks. Code examples for Node.js, Python, and PHP are available in the documentation.

How do I get eSIM API access?+

Create an eSIMfly business account, then generate API keys from the business dashboard. Wholesale pricing tiers depend on volume — contact our sales team to discuss rates for your expected order volume.

Does the API support webhooks?+

Yes. You can register webhook endpoints to receive real-time notifications about order status, eSIM lifecycle changes, and usage events, so your application stays in sync without polling.

What are the API rate limits?+

The API allows 1,000 requests per hour per account. Requests older than 5 minutes are rejected as part of replay-attack protection. If you need higher limits for your integration, contact sales.

Ready to integrate eSIMs into your product?

Start with the documentation, or talk to our team about wholesale rates for your volume.