A connected arrival.
Bring destination data into the journey from booking to arrival, with clear compatibility and installation steps.
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.
fieldnotes. / mobileESMake yourself
at home.
10GB
SpainIllustrative plan
Your brand. Your customer relationship.
2.4 GB used · 7.6 GB remaining
Choose your offerPrivate installationYour ongoing servicePLAN & DEVICEINSTALLATION JOURNEYAFTER ACTIVATION
A plan that fits.
Ready to connect.
Stay useful.
01
Device readinessCompatible, unlocked eSIM device
↗02
InstallationPrivate instructions in the customer account
·03
Usage & top-upsOffer-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.
Read Bird customer storiesBIRD eSIMEvery step has its own result.
DOCUMENTED OPERATING BEHAVIORInstalled is a step.
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 ↗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 YOURSELFFrom a new plan
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.
YOUR APP / SUBSCRIBER JOURNEY
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 dataEmployee travelRecurring service evaluation · Spain
10 GBFictional travel allowance
Device: mobile data observed · usage unobserved
Device: profile installed · mobile service not verified
Device: no installed profile
Original order: none · provider activation: unknown
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 · Work through installation.
WHAT IT MEANS FOR YOUR CUSTOMERPart of their trip.
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.
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.
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.
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 ↗Build a service around your people.
Scope assignment, travel needs, usage, and the support path that keeps employees connected.
Plan workforce connectivity ↗GET STARTED
Shape the offer. Plan the launch.
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.
LIFECYCLE RECORD / ILLUSTRATIVE
Prepare the request
- Original request
- Not created
- Profile allocation
- Unconfirmed
- Financial observation
- Unresolved
- Installation
- Not established
- Destination data
- 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.
Node.js · read guide Markdownguide.mts: npx tsx guide.mtsconst 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);
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 ↗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 ↗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 ↗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 CONNECTIVITY10 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.
f.
FieldnotesTo: Alex Lee ⌄
A connected beginning.
fieldnotes.YOUR SPAIN DATA PLANA connected
beginning.
Alex · 10 GB plan
Install through your account.
Open your secure account ↗
beginning.
Alex · 10 GB planInstall through your account.
Open your secure account ↗
02
Email ↗
Send a link to authenticated installation instructions.
f.
FieldnotesBusiness account
Today · 9:41
I need help installing my Spain data plan.
I can help, Alex. Let’s open the installation steps in your account.
03
WhatsApp ↗
Your support team receives the plan context when Alex needs help.
LEARN / BUILD / OPERATEGo further with
FIELD GUIDE
Go further with
eSIM & connectivity.
FIELD GUIDEBuild the service around your relationship.
A practical path through setup, implementation, and the choices that matter.
Read the field guide →01↗02↗03↗04↗05↗06↗
Choose a connectivity journey ↗Plan your eSIM integration
Connect offer selection, installation and ongoing support.
Guide eSIM installation
Private setup and device first use.
Operate the service
Service choices and operating responsibilities.
Choose the service
Travel, employee and recurring evaluation.
Check destination coverage
Unknown networks and service terms remain visible.
Prepare launch readiness
Access, offer, fulfillment, device and support.
CONNECTIVITY / COMMERCIAL PLANNINGYour relationship.
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.
Discuss your connectivity offer ↗YOUR ESIM & CONNECTIVITY SETUPA 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.
eSIM & connectivity, answered.
A FEW USEFUL ANSWERS
¿Una API de eSIM es solo un endpoint de código de instalación?
No. Una integración útil también cubre descubrimiento de ofertas, compra, aprovisionamiento, estado del servicio y gestión continua. Las credenciales de instalación son una parte privada de ese ciclo de vida.
¿Puede un agente de programación construir la integración?
Un agente puede trabajar a partir de la descripción actual de la API, las guías de tareas y tu aplicación. Haz que inspeccione las operaciones compatibles y demuestre un recorrido completo controlado; no asumas que un método existe por un ejemplo de marketing.
¿Cómo debemos manejar una respuesta de compra incierta?
Conserva la solicitud original y la identidad del pedido, y luego usa el comportamiento de recuperación documentado para establecer su resultado. Iniciar una nueva compra puede generar otro cargo o servicio.
¿Qué debe incluirse en la medición de conversión?
Registra el resultado de negocio que quieres optimizar, como una compra completada o un primer uso verificado. Conserva el contexto de adquisición a lo largo del traspaso correspondiente y vincúlalo a ese resultado sin incluir credenciales de instalación privadas.
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.
Ponlo en práctica.
Continúa con la documentación, guías y ejemplos sobre este tema. Los recursos están en inglés.