eSIM & Embedded Mobile Connectivity # Mobile connectivity. Mobile data inside your app. Embed mobile data plans in your app. Let customers choose an offer, install their eSIM and manage usage through one connected experience. [Start now](/dashboard/signup?returnTo=%2Fdashboard%2Fw%2Fesim) [Talk to sales](/demo?product=esim-api) BIRD / ESIM & CONNECTIVITY Illustrative experience 01 Choose a plan 02 Prepare installation 03 Manage the connection Replay ↺ Resume Pause Mediterranean coastline fieldnotes. / mobile ES YOUR CONNECTION / SPAIN ### Make yourself at home. 10 GB Spain Illustrative plan Your brand. Your customer relationship. 2.4 GB used · 7.6 GB remaining Choose your offer Private installation Your ongoing service PLAN & DEVICE INSTALLATION JOURNEY AFTER ACTIVATION ### A plan that fits. ### Ready to connect. ### Stay useful. 01 Device readiness Compatible, unlocked eSIM device 02 Installation Private instructions in the customer account 03 Usage & top-ups Offer-dependent services and reporting Coverage, term, activation, and compatible top-ups depend on the selected offer. Example content and data. Explore the workflow below; nothing is sent or changed in a live account. Companies that trust Bird across their communications. - [Airwallex](/customers/airwallex) - Uber - [Zillow](/customers/zillow) - [Glovo](/customers/glovo) - PayPal - Adobe [Read Bird customer stories](/customers) BIRD eSIM Every step has its own result. DOCUMENTED OPERATING BEHAVIOR ## Installed is a step. Connected is the outcome. The installation guide separates a fulfilled order, private setup and a device test in a covered destination. Keep the customer’s observed result separate from the provider’s status, and check reinstall eligibility before removing a profile. [Read the installation guide ↗](/docs/guides/esim/installation) Source checked 18 September 2026. Documented procedure with an illustrative device journey. Check the selected offer’s coverage and device requirements before installation. ESIM & CONNECTIVITY / TRY IT YOURSELF ## From a new plan to everyday use. The scene above is a separate Spain travel illustration. Here, follow a fictional order through fulfillment, private installation and first use; recover a failed setup without purchasing twice. Interactive examples require JavaScript. Product details, setup choices, and guides remain available below. YOUR APP / SUBSCRIBER JOURNEY Business model Travel data example Employee travel example Recurring · confirm access Illustrative destination Spain · example only Japan · coverage unknown Device readiness Readiness unknown Variant checked · unlocked eSIM capable · carrier locked Purchase outcome Accepted · pending Waiting for funding Failed · nothing fulfilled Response lost · unknown Preview purchase ↗ Reconcile original order Preview private setup Test first use Recover setup / connection Reset example Device test outcome Installed · data observed Installation fails Installed · no data Private setup unavailable Check the exact device and unlocked status, then follow one example order. Nothing is purchased or installed. Check device, coverage and access before the fictional purchase. No current offer, price or availability is implied. Selected a device test. Purchase fulfillment and installation are still separate prerequisites. Choose a supported offer for the intended market and service. Prepare market, subscriber, renewal, cancellation and support requirements with a specialist. Coverage unknown for this fictional itinerary. Confirm the dated destination list, networks and published offer before purchase. Carrier locked: stop before purchase. Ask the current carrier about unlocking, then recheck the exact device variant. Device readiness unknown: record model, region variant, OS and carrier lock; this browser cannot inspect the phone. Keep the original order reference. Reconcile it before considering another purchase; a repeated click creates no second example order. Accepted, fulfillment pending. No installed profile or connection is established. Reconcile the original order. Waiting for wallet funding. The funding requirement is the total wallet balance, not the shortfall; no package is fulfilled. Resolve funding and reconcile the same order. Order failed. No package fulfilled; inspect the failure and any returned charge before a new approved attempt. Reconciliation does not turn a failure into success. Purchase response lost. Outcome unknown. Keep the original reference and retry identity; reconcile before another purchase. There is no original order to reconcile. Check readiness and preview one purchase first. Original order remains failed. Inspect the reason and refund status with support. Reset only to start a separate fictional attempt. Original order already completed. No second purchase was created; installation and first use remain separate. Example original order reconciled as completed; the charging case assumes funding was resolved. One package fulfilled. Private installation and device first use still need verification. Wait for fulfilled service and private installation eligibility. Pending, unknown or failed purchase is not setup-ready. Private setup unavailable. Carrier credentials could not be read or the profile is not installable. Retain the original order and ask support; never expose activation material. Installation failed on the example device. Record model, method, step and exact error. Check reinstall eligibility before deleting the profile. Example profile installed through private setup. No real credential is displayed. Check the offer’s activation trigger and test the selected data line in coverage. A fulfilled order alone cannot connect the phone. Complete the eligible private installation first. Profile installed, but no mobile data observed. Check covered destination, selected data line and offer roaming settings. Do not buy another package to diagnose this. Fictional device test: mobile data observed. Provider activation remains unknown; a delayed usage observation is separate from this device result. No live service was tested. No recorded setup issue. Keep order, profile and device observations separate; use the installation guide for an actual test. Example data-line and roaming settings corrected in coverage. Repeat the device test; recovery is not yet a connection. Example support review confirms private setup / reinstall eligibility. Retry private setup on the intended device; no new order was created and no profile was deleted. THE PLAN / INSTALL TO EVERYDAY FIELDNOTES / CONNECTIVITY ◉ ### Travel data Employee travel Recurring service evaluation 10 GB Fictional travel allowance Device: mobile data observed · usage unobserved Device: profile installed · mobile service not verified Device: no installed profile Usage has not been observed; the empty meter is not a zero-balance reading. Example only, not catalogue stock or a current rate. A completed order does not prove installation or mobile service. Private credentials are never shown here. Interactive illustration · fictional customer and results · no account, order, activation or device action. [Plan the integration](/docs/guides/esim/api) · [Work through installation](/products/esim/installation) . WHAT IT MEANS FOR YOUR CUSTOMER ## Part of their trip. Part of their everyday. Make mobile connectivity part of the relationship you already have. Choose the offer, installation experience, and support model that fit your customer. 01 / Travel ### A connected arrival. Bring destination data into the journey from booking to arrival, with clear compatibility and installation steps. 02 / Everyday mobile ### A service they keep coming back to. Choose a supported offer for the intended market and service. Prepare service, renewal and cancellation requirements with a specialist. 03 / Employee connectivity ### A clearer work-travel experience. Prepare assignee, payer, travel needs and a staffed recovery path; confirm supported assignment and usage access. FIND YOUR WAY IN ## Build the service around your relationship. A customer offer ### Build connectivity into your product. Plan the destinations, supported services, compatible devices, and the experience you want your brand to own. [Talk through your offer ↗](/demo?product=esim-api) A team or workforce ### Build a service around your people. Scope assignment, travel needs, usage, and the support path that keeps employees connected. [Plan workforce connectivity ↗](/docs/guides/esim/employee-connectivity) ### The details behind your setup #### Travel eSIMs Offer destination data beside the trip. Check the destination, supported networks, device compatibility, and installation instructions. #### Everyday mobile plans Choose a supported offer for the intended market and service. Prepare market, renewal, cancellation and care requirements with a specialist. #### Employee connectivity Prepare assignee, payer, work destinations and support responsibility. Confirm available assignment and service operations before promising fleet management. GET STARTED ## Shape the offer. Plan the launch. [Start now](/dashboard/signup?returnTo=%2Fdashboard%2Fw%2Fesim) [Talk to sales](/demo?product=esim-api) 01 [Set up your integration ↗ Connect your workspace and review the integration guide.](/docs/guides/esim/api) 02 [Check offer and readiness ↗ Confirm coverage, price, device and private installation.](/products/esim/getting-started) 03 [Prepare the workspace ↗ Set up your workspace, choose an offer and prepare a supported device.](/dashboard/signup?returnTo=%2Fdashboard%2Fw%2Fesim) eSIM / integration brief ## Keep the intent. Observe the outcome. Connect an eligible offer, an authorized purchase and the customer’s device journey. Rehearse recovery before implementing against the supported contract. Illustrative integration / O-410 ### One original request. Exact offer and capabilities confirmed for this example Customer and payer authorize this purchase Initial response Accepted; fulfillment pending Final response lost Confirmed order failure Fulfilled allocation Record example request Read original order Observe private installation Observe first data use [Prepare the supported integration ↗](/docs/guides/esim/api) LIFECYCLE RECORD / ILLUSTRATIVE Original request Not created Profile allocation Unconfirmed Financial observation Original record retained Inspect charge and refund Unresolved Installation Device reports installed Not established Destination data Device session observed Unobserved Usage and provider activation Unknown Select an illustrative outcome. No endpoint is called and no real order is created. Private installation material belongs in an authorized customer flow. Exclude it from analytics, public examples and support screenshots. ## Build with the integration context. Connect offer selection, installation and support in one customer journey. Give your coding agent the setup guide before planning how that journey fits your application. Read the guide as Markdown from your application or terminal. The examples retrieve documentation; the guide explains the service decisions and operating responsibilities. [Explore the setup guide ↗](/docs/guides/esim/overview) [Find guides with the CLI ↗](/docs/cli/reference/docs-search) [Read a guide with the CLI ↗](/docs/cli/reference/docs-read) [Set up your coding agent ↗](/docs/ai/set-up-your-agent) [Move an existing integration ↗](/docs/guides/esim/migrate) [Explore eSIM resources ↗](/esim/resources) [Compare connectivity providers ↗](/products/esim/compare) **Node.js**: `Node.js · read guide Markdown` File: `guide.mts` Run: `npx tsx guide.mts` ```typescript const response = await fetch("https://bird.com/docs/guides/esim/overview.md"); if (!response.ok) { throw new Error(`Guide request failed: ${response.status}`); } const guide = await response.text(); console.log(guide); ``` Examples: [TypeScript](/fr-fr/esim-api.ts.md) · [Python](/fr-fr/esim-api.py.md) · [CLI](/fr-fr/esim-api.cli.md) YOUR CUSTOMER EXPERIENCE ## Clarity from checkout to connection. Your customers need to know what happens next. Build purchase progress, installation guidance and ongoing support into your eSIM experience. ### Show purchase progress Keep customers informed while their eSIM is prepared. Follow the original order if a connection drops during checkout. [Explore the integration guide ↗](/docs/guides/esim/api) ### Guide the first connection Help customers check their device, install their eSIM and connect at their destination, with clear guidance at each step. [See the installation guide ↗](/docs/guides/esim/installation) ### Make support simpler Bring order, installation and usage information together so your team can understand the issue and help customers keep moving. [Read the operations guide ↗](/docs/guides/esim/operations) THE COMPLETE BIRD PLATFORM ## Connectivity with the whole journey around it. Keep private installation in the authenticated customer flow. Send a link to it and support the customer using order and device observations. YOUR BRANDED CONNECTIVITY 10 GB Example plan Spain Installation In the customer account Usage 2.4 GB · illustrative 01 ### eSIM This step A fictional order is fulfilled before Alex follows private installation. [A connected beginning. fieldnotes. YOUR SPAIN DATA PLAN A connected beginning. Alex · 10 GB plan Install through your account. Open your secure account ↗](/products/email) 02 ### [Email ↗](/products/email) Send a link to authenticated installation instructions. [Today · 9:41 I need help installing my Spain data plan. I can help, Alex. Let’s open the installation steps in your account.](/whatsapp) 03 ### [WhatsApp ↗](/whatsapp) Your support team receives the plan context when Alex needs help. BUILD YOUR BIRD SETUP A useful next connection. [SMS ↗ Keep customers informed Send timely plan and usage communications.](/products/sms) [WhatsApp ↗ A familiar route to help Bring service questions into a conversation.](/whatsapp) [Agent mailboxes ↗ A place for follow-up Keep written support in your application workflow.](/agent-mailboxes) [Realtime ↗ Show the current experience Publish application updates into your own service interface.](/realtime-messaging-api) Keep the connectivity service, activation guidance, email receipts, and support conversations under the same communications partnership. Your application keeps the subscriber relationship together. [Plan your complete Bird setup ↗](/demo?product=esim-api) LEARN / BUILD / OPERATE ## Go further with eSIM & connectivity. [FIELD GUIDE Build the service around your relationship. A practical path through setup, implementation, and the choices that matter. Read the field guide →](/guides/launch-embedded-esim-connectivity) [01 Plan your eSIM integration Connect offer selection, installation and ongoing support. ↗](/docs/guides/esim/overview) [02 Guide eSIM installation Private setup and device first use. ↗](/docs/guides/esim/installation) [03 Operate the service Service choices and operating responsibilities. ↗](/docs/guides/esim/operations) [04 Choose the service Travel, employee and recurring evaluation. ↗](/esim) [05 Check destination coverage Unknown networks and service terms remain visible. ↗](/products/esim/coverage) [06 Prepare launch readiness Access, offer, fulfillment, device and support. ↗](/products/esim/getting-started) [Choose a connectivity journey ↗](/esim) CONNECTIVITY / COMMERCIAL PLANNING ## Your relationship. Your mobile offer. Choose an offer for your destinations, plan type and expected usage. Review the published price and service terms before purchase. [Start now](/dashboard/signup?returnTo=%2Fdashboard%2Fw%2Fesim) [Talk to sales](/demo?product=esim-api) [Discuss your connectivity offer ↗](/demo?product=esim-api) YOUR ESIM & CONNECTIVITY SETUP A tailored offer Match coverage and included services to your destinations. The offer Published price and currency, allowance, destinations, dates and activation trigger. The customer Exact device variant, carrier unlock, private installation and observed first use. The operation Support, delayed usage, service-compatible top-ups and recurring renewals under the selected plan’s terms. [Review current eSIM price guidance ↗](/products/esim/pricing) ## eSIM & connectivity, answered. A FEW USEFUL ANSWERS ### Is this only for travel eSIMs? Start with an eligible data offering for travel or employee use. Choose a supported offer for the intended market and service. Review the selected offer’s terms before purchase. ### Will every phone work? No. Confirm exact model, market variant, OS and carrier-unlocked status with manufacturer and provider guidance. This page cannot detect the device or certify compatibility. ### How do I integrate eSIM into my application? Start with workspace setup and the eSIM integration guide. Choose an eligible offer and keep installation credentials inside your authorized customer experience. ### Is a completed order already a connected phone? No. Separate purchase fulfillment, private installation, offer activation rules and an observed device service test. Reconcile the original order before another purchase if the response is lost. ### Which top-up and lifecycle operations should we plan? The eSIM dashboard supports data-package purchase and compatible top-ups. Match a top-up to the existing service, not geography alone; check its price, limits and validity. Recover the original nonterminal order before retrying a purchase. Funding cancellation and supplier-dependent suspend, resume or release have their own eligibility and outcome checks; an accepted action is not proof the network changed. Confirm supported operations and region with Bird. See the pricing and plan details. ### Does every plan include calls, SMS, and top-ups? No. Features follow the selected offer. Check the destination, device, services, renewal terms, and compatible top-ups before purchase. See the pricing and plan details. ### Where should installation details be delivered? Keep private installation details in the authenticated account. A communication can link the customer to that protected setup flow. ### How do I get started or speak to sales? Start in your workspace and follow the setup steps for your channel. Talk to sales for help planning a larger rollout. YOUR NEXT CONNECTION ## Be part of their everyday connection. [Start now](/dashboard/signup?returnTo=%2Fdashboard%2Fw%2Fesim) [Talk to sales](/demo?product=esim-api) [Explore the whole Bird platform ↗](/products) ## Related resources - [What is an eSIM?](/explained/esim/what-is-an-esim) (answer) [Get an implementation brief](/learn/workspace?topic=esim)