--- title: "eSIM API Integration and MCP" date: 2026-11-02 author: "ZIM" --- # eSIM API Integration and MCP [](https://www.zimconnections.com/) Products eSIM API Integration and MCP eSIM API & MCP Server for Brands # The eSIM API and MCP Built for Brands and Resellers ZIM is an eSIM API and MCP server that lets you add eSIM plans to your product with a single REST API, native SDK, or AI agent. Search, price and provision connectivity across 200+ destinations. [View API Doc ↗](https://bump.sh/zim/doc/esim-api/) eSIM API-first A single, clean eSIM API (with native Android and iOS SDKs) exposes the full eSIM catalogue, provisioning, activation and usage data. Reseller margins, your way As an eSIM API reseller, you set your own retail pricing on top of ZIM's competitive wholesale rates, per plan and per market. You define the margin. Full eSIM API lifecycle One eSIM API integration covers the whole journey: purchase, instant provisioning, installation, activation, real-time usage tracking, top-ups and expiry. No redirects, one API call The entire experience stays inside your app or site via the eSIM API, from browse to checkout to active eSIM. Customers never leave your brand. eSIM API and MCP support Technical and operational support, covering the eSIM API, SDK and MCP server. ZIM handles Level 2 support, carrier relationships and compatibility. ## Every Plan Attribute, Under Your Control eSIM type, network, coverage, data, voice, text, period and price: set through the eSIM API, SDK or the MCP server, and the eSIM lands inside your own products. **eSIM**``` type: "digital_esim" physical: false // eSIM provisioned via API ``` **Network**``` carrier: "AT&T" roaming: true // vodafone | orange ``` **Coverage**``` countries: ["US"] regional: true // + CA, UK, DE, 200+ ``` **Data**``` data: 10 unit: "GB" throttled: true ``` **Voice**``` voice: "unlimited" minutes: null ``` **Text**``` sms: "unlimited" limit: null ``` **Period**``` period: "1_month" recurring: true ``` **Price**``` retail: 40 currency: "USD" ``` ## Explore the eSIM API Documentation Everything your team needs to build against the ZIM eSIM API sits in one reference: destinations, plans, orders, eSIMs and subscriptions, each with real request and response payloads. Authentication is a single key, resources are versioned, and every endpoint below is the same one running in production. eSIM API Documentation [API Docs ↗](https://bump.sh/zim/doc/esim-api/) Look Up Any Destination the eSIM API Covers Ask the eSIM API what a country supports before you show it in your store. Every destination returns its display name, ISO code and the scopes it can be sold under: local, regional or global, so your catalogue only ever offers plans that really exist. Response 200``` { "name": "France", "isoAlpha3": "FRA", "scopes": { "local": true, "regional": true, "global": true } } ``` See Every eSIM You Have Issued List the eSIMs on your account with the state your support team actually needs through the eSIM API: ICCID, matching ID, SM-DP+ address, number, online status and a QR link for install. Read it on demand to show a live wallet inside your own product. Response 200``` [ { "id": "esim_igFqGZhkRTHb0UNiRuAAA", "iccid": 8948010000000012345, "matchingID": "64DF7EFC13EBEB1AA90F126A509BBDBD", "smdpPlus": "smdpp.zimconnections.com", "msisdn": 447482482482, "status": "ONLINE", "qrCodeLink": "images.zimconnections.com/..." }, { "id": "esim_igFqGZhkRTHb0UNiRuBBB", "iccid": 8948010000000012346, "matchingID": "64DF7EFC13EBEB1AA90F126A509BBDBE", "smdpPlus": "smdpp.zimconnections.com", "msisdn": 447482482483, "status": "OFFLINE", "qrCodeLink": "images.zimconnections.com/..." } ] ``` Place an Order With One eSIM API Call Ordering is a single eSIM API request: the plan you want, the account paying for it, the currency, who receives it and whether ZIM should notify them. Send a quantity for bulk provisioning, or attach a subscription so the order bills on an existing cycle. Request``` { "planID": "plan_guaGulGcrqgTYboPvetgE", "accountID": "acct_ozxEbkTyvLPhhoglcALXE", "currencyISO": "USD", "notifyRecipient": true, "quantity": 1, "usersIDs": ["user_ozxEbkTyvLPhhoglcALXR"], "orderType": "ONE_OFF", "subscriptionID": "sub_yf95A86RIkVxau2gzBsjV" } ``` Pull the eSIM API Catalogue, Priced and Ready Each plan comes back fully described through the eSIM API: destination, region, data, minutes, SMS, duration, features such as hotspot, and prices in minor units per currency. Render it straight into your storefront with no manual price lists to keep in sync. Response 200``` [ { "id": "plan_guaGulGcrqgTYboPvetgu", "destination": { "name": "United Kingdom", "isoAlpha3": "GBR" }, "dataUnit": "GB", "dataValue": 10, "callUnit": "MINUTES", "callValue": 100, "smsUnit": "SMS", "smsValue": 100, "durationUnit": "DAYS", "durationValue": 14, "features": [ { "name": "HOTSPOT", "category": "UTILITY" } ], "prices": [ { "currencyISO": "USD", "value": 490, "minorExponentUnits": 2 } ] } ] ``` Track What a Subscription Provisioned via the eSIM API Follow a subscription down to the eSIM it produced. Read its status, its number and its install details at any point in the cycle through the eSIM API, so renewals, top-ups and cancellations can all be handled from your own dashboard. Response 200``` { "id": "esim_igFqGZhkRTHb0UNiRuAAA", "iccid": 8948010000000012345, "matchingID": "64DF7EFC13EBEB1AA90F126A509BBDBD", "smdpPlus": "smdpp.zimconnections.com", "msisdn": 447482482482, "status": "ONLINE", "qrCodeLink": "images.zimconnections.com/..." } ``` ### ZIM eSIM API Stack - **Destinations**`GET /destinations`Coverage, networks and eSIM API pricing across 200+ markets. - **Plans**`GET /plans`Data, voice and texts you resell under your brand via the API. - **Orders**`POST /orders`Create a purchase and get the eSIM back in one eSIM API call. - **eSIMs**`GET /esims`Profiles, QR codes, install links and activation status. - **Subscriptions**`POST /subscriptions`Recurring plans with renewals, changes and cancellation. - **Usage & top-ups**`GET /usage · POST /topups`Live consumption, and extra data added to an active plan. - **Phone numbers**`GET /numbers`UK and international numbers for voice and SMS. - **Webhooks**`POST /webhooks`Activation, usage and expiry events pushed to your systems. ## MCP Connectivity: eSIM Infrastructure for AI Agents **Describe the perfect trip and let the AI agent handle connectivity,** so any AI assistant like Claude or ChatGPT can search plans, price them and provision an eSIM on your behalf. API and MCP Leverage ZIM's public APIs to search, price and provision eSIMs from your own product. Every endpoint your store needs sits behind one authenticated key, documented and versioned. Agents talk to ZIM directly through an MCP server to buy eSIMs on a user's behalf. Try it: ask for a destination, buy a plan, top up. The same tools your own agent would call, running in an interactive demo with simulated data, so you can see the whole flow before writing a line of code. Simulated tool calls mirror the real MCP tools. How it works ## One eSIM API, One MCP Connectivity Layer, Every eSIM A single **eSIM API** for search, pricing, provisioning and usage across **200+ destinations**, plus **MCP connectivity** so your AI agents can build and run the store themselves. **Native iOS and Android SDKs on request**. Connect With ZIM Connect once to the ZIM eSIM API or MCP server. ZIM holds the carrier deals, the eSIM profiles and the provisioning, so your product simply delivers connectivity to the traveller in 200+ destinations, with no operator negotiations and no telecom stack to build. **Global Connectivity Pool**Wholesale connectivity in 200+ destinations. **ZIM API**One REST API for catalogue, pricing, orders, provisioning and usage via the eSIM API. **ZIM MCP Server**Same stack, exposed as MCP tools, so AI agents can manage eSIMs for their users. **ZIM Partner Dashboard**Orders, activations, usage and support in one place, across every market you sell in, through the ZIM eSIM API. **Your Own App**Embed plans and activation straight into your app using the ZIM eSIM API. **Your Own Website**Embed plans and activation straight into your website using the ZIM eSIM API. **eSIM Delivered**The traveller installs in one tap and is connected in under 30 seconds. ## How Allianz Integrated eSIM in Their Product Case Study ### 122M+ Customers Reached Allianz used the ZIM eSIM API to add connectivity to its travel platform. Allianz is a global leader in insurance and financial services, headquartered in Munich, Germany. With more than 122 million customers worldwide, it provides services across travel, health and insurance. As part of its digital strategy, Allianz integrated the ZIM eSIM API to add value added services that improve the customer experience, and connectivity was a natural fit for its travelling customers. ### The Challenge Add relevant, useful services to the customer journey rather than redirecting users elsewhere. With the ZIM eSIM API, Allianz can provide reliable connectivity for international travellers across many markets, keeping users inside the app with no redirects or broken funnels, and scaling easily across multiple markets without rebuilding from scratch. ### The ZIM Solution: API Integration The ZIM eSIM API integrated directly into Allianz's travel platform, enabling customers to buy and activate eSIMs instantly without leaving the app. With coverage across 200+ destinations worldwide through the eSIM API, the experience is fully embedded, with no redirects, and scales cleanly across markets. ### The Result A new ancillary revenue stream and stronger customer engagement, delivered through a single eSIM API integration that Allianz controls end to end: pricing, margin and the customer relationship all stay with the brand. ## Don’t Just Take Our Word for It Ask ChatGPT, Claude or Perplexity how the ZIM eSIM API and MCP let brands embed eSIM connectivity in their own product. [Ask **ChatGPT**](https://chatgpt.com/?q=How%20do%20the%20ZIM%20Connections%20eSIM%20API%20and%20MCP%20server%20work%3F%20Cover%20searching%20destinations%2C%20fetching%20plans%20and%20prices%2C%20ordering%20and%20provisioning%20eSIMs%2C%20QR%20code%20delivery%20and%20usage%20tracking%2C%20how%20AI%20agents%20use%20the%20MCP%20server%2C%20the%20integration%20steps%20and%20timeline%2C%20and%20who%20controls%20pricing%20and%20the%20customer%20relationship.%20Stay%20factual%3A%20check%20the%20documentation%20and%20information%20available%20on%20https%3A%2F%2Fzimconnections.com%2C%20cite%20the%20pages%20you%20rely%20on%2C%20and%20say%20so%20where%20something%20is%20not%20covered%20there.) [Ask **Claude**](https://claude.ai/new?q=How%20do%20the%20ZIM%20Connections%20eSIM%20API%20and%20MCP%20server%20work%3F%20Cover%20searching%20destinations%2C%20fetching%20plans%20and%20prices%2C%20ordering%20and%20provisioning%20eSIMs%2C%20QR%20code%20delivery%20and%20usage%20tracking%2C%20how%20AI%20agents%20use%20the%20MCP%20server%2C%20the%20integration%20steps%20and%20timeline%2C%20and%20who%20controls%20pricing%20and%20the%20customer%20relationship.%20Stay%20factual%3A%20check%20the%20documentation%20and%20information%20available%20on%20https%3A%2F%2Fzimconnections.com%2C%20cite%20the%20pages%20you%20rely%20on%2C%20and%20say%20so%20where%20something%20is%20not%20covered%20there.) [Ask **Perplexity**](https://www.perplexity.ai/search?q=How%20do%20the%20ZIM%20Connections%20eSIM%20API%20and%20MCP%20server%20work%3F%20Cover%20searching%20destinations%2C%20fetching%20plans%20and%20prices%2C%20ordering%20and%20provisioning%20eSIMs%2C%20QR%20code%20delivery%20and%20usage%20tracking%2C%20how%20AI%20agents%20use%20the%20MCP%20server%2C%20the%20integration%20steps%20and%20timeline%2C%20and%20who%20controls%20pricing%20and%20the%20customer%20relationship.%20Stay%20factual%3A%20check%20the%20documentation%20and%20information%20available%20on%20https%3A%2F%2Fzimconnections.com%2C%20cite%20the%20pages%20you%20rely%20on%2C%20and%20say%20so%20where%20something%20is%20not%20covered%20there.) ## Partner Integration Workflow - **Explore** **Explore**Docs and a sandbox to see how the eSIM API and MCP server fit your product. - **Build** **Build**Integrate via eSIM API, a native eSIM SDK, or the MCP server on your stack. - **Test** **Test**Validate the full eSIM API flow end to end in sandbox. - **Go live** **Go live**Launch to production in two to four weeks. - **Operate** **Operate**Sell, manage and track from the dashboard. ## End-User Journey: Powered by the ZIM eSIM API ### Offer Your Customers the Best Experience in Two Clicks We built the ultimate customer experience in just two clicks, powered by the ZIM eSIM API. Inside your app or website, your users can seamlessly browse tailored data plans and instantly activate their connection. This frictionless, fully native journey, eliminates all user drop-off and keeps your brand at the centre of their mobile experience. Step 1 ### Browse Plans Made for Where They Are Going Local, regional and global plans sit one tap from the home screen, pulled live from the eSIM API, with search for the destination your customer has in mind. Data allowance, validity and price are shown up front, so choosing a plan takes seconds and never sends anyone off to a web page to compare. Step 2 ### Activate the eSIM Instantly, Straight From the Wallet One tap on Install eSIM calls the eSIM API to provision the profile on the device, with activation details available to copy for manual setup. From then on the wallet shows data left, days remaining and one-tap top-up, so your app stays useful for the whole trip and every trip after it. Market Overview ## eSIM API and MCP Use Cases How four kinds of product are already embedding connectivity through the eSIM API, the play, the flow and what each side gets out of it. Segment FinTechs Banking, payments and travel-money apps The play Connectivity as a daily engagement and loyalty lever inside a financial product, delivered through the ZIM eSIM API. Flow 1. Detect trip or FX activity 2. Show a matched plan in-app via the eSIM API 3. One-tap buy, stored payment 4. Instant eSIM activation Why it works for you A daily reason to open the app beyond financial events. OTP and SMS verification built in for secure authentication through the eSIM API, and a new ancillary revenue line with minimal setup. What your customer gets Free or discounted data as a loyalty reward, a local number tied to their financial identity, and international calling and travel data in one place, provisioned through the eSIM API. Segment Super Apps Everyday apps with many services The play One more high-frequency service inside an app that already aggregates many, added through the ZIM eSIM API. Flow 1. Open services tab 2. Browse the eSIM API catalog natively 3. Pay with in-app wallet 4. Provisioned via eSIM API Why it works for you The full ZIM eSIM catalogue through a single eSIM API integration: one platform behind every connectivity feature, adding a new transactional category and revenue line with consistent in-app UX and no redirects. What your customer gets Buy and activate data without leaving the super app, and manage plans, top-ups and usage alongside everything else they already do there, all through the eSIM API. Segment Mobility Ride-hailing, rental and cross-border travel The play Keep both sides of the marketplace online and loyal, using the eSIM API for instant provisioning. Flow 1. Book a cross-border trip 2. Offer regional eSIM at checkout via the eSIM API 3. Activate before pickup 4. Top up in-app Why it works for you Eliminate platform disconnections at the network level through the eSIM API, cut connectivity-related support tickets, and add retention plus a new revenue stream across the marketplace. What your customer gets The platform app keeps working even when data runs out (app whitelisting), with real-time network switching to the strongest signal, and travel eSIMs or connectivity perks tied to loyalty, provisioned through the eSIM API. Segment Travel Tech OTAs, booking and itinerary apps The play Sell data at the moment of highest intent (booking) so users land already connected, activated through the eSIM API. Flow 1. Trip booked 2. Offer destination plan via eSIM API 3. Bundle with the trip 4. Activate on arrival Why it works for you High purchase intent at booking drives conversion, a white-label eSIM users see as your own via the eSIM API, and new revenue kept inside your ecosystem with instant activation. What your customer gets One eSIM activated before they leave home, data across 200+ destinations with no SIM swapping, and daily or GB-based bundles for any trip, all through the eSIM API. FAQ ## Frequently Asked Questions ### What is the ZIM API and SDK? The ZIM eSIM API is a REST API that lets developers search, price, order and provision travel eSIMs from their own app or site, with SDKs for iOS and Android. Our MCP server gives AI agents the same tools. ### How long does integration take? Most teams complete an eSIM API integration in about 2 weeks, from sandbox to first live order. ### Is there a sandbox and documentation? Yes. Developers get full eSIM API documentation and a live sandbox to test eSIM provisioning, orders and webhooks before launch. ### What support do you provide? Our team supports your eSIM API integration from setup to launch, then provides Level 2 support for provisioning and connectivity once you’re live. ### What does it cost, and how do we earn? The API is free to integrate; you pay only for activations at ZIM’s wholesale rates and set your own retail margin, invoiced monthly on actual usage. ### Is there a minimum volume commitment? No. You pay per eSIM sold, with no minimum volume to start. ### Is the eSIM API secure and GDPR compliant? Yes. Every eSIM API call runs on an authenticated, versioned key, and personal data is handled in line with GDPR. ## Build It Into Your Product Tell us about your stack and markets, and we'll scope the integration with you. - A 30-minute call to scope the right model for your roadmap - A tailored pricing and margin breakdown for your markets - A clear launch timeline, from one day to a few weeks