{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown"},"seo":{"title":"Classic eSIM Grants","description":"Integrate Hubby eSIM into your travel platform with our comprehensive API documentation, tutorials, and guides.","keywords":"hubby, esim, api, travel, integration, documentation"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"classic-esim-grants"},"children":["Classic eSIM Grants"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Classic eSIM grants let your backend pre-stage a ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["single-IMSI eSIM"]}," for a User, who claims it from inside your native app. Unlike the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/native-api"},"children":["universal-eSIM Native Integration"]}," — which centralises a traveler's data on one ICCID and queues packages onto it — a classic grant provisions a fresh ICCID (or tops up onto a matching existing one) per claim. It's the right fit for use cases that don't share the universal-eSIM mental model:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Loyalty rewards"]}," — \"thank you for flying with us, here's 1 GB of Spain data\"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Refund / retention grants"]}," — issued case-by-case without trip context."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Sponsorship-style perks"]}," — one-off eSIMs without recurring travel data needs."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Already using the Native eSIM Integration?"]}," Classic grants coexist with the universal flow on the same Booking endpoint and the same Partner credentials. The choice is per ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package_specifications[]"]}," entry via the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["esim_type"]}," field — you can mix universal and classic specs in the same Booking."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"how-it-differs-from-the-universal-esim-flow"},"children":["How it differs from the universal-eSIM flow"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Aspect"},"children":["Aspect"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Universal ( esim_type: 'universal' )"},"children":["Universal (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["esim_type: 'universal'"]},")"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Classic ( esim_type: 'classic' )"},"children":["Classic (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["esim_type: 'classic'"]},")"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["ICCID lifecycle"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One per traveler, reused across packages"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["One per claim (or topped-up onto a matching existing eSIM)"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Identifier required on spec"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_user_id"]}," only"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Either ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_user_id"]}," ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["or"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Redemption surface"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Hubby WebView inside your app"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Native onCalls invoked from your app"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Trip context"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["departure_date"]}," always meaningful"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["departure_date"]}," may be omitted — server defaults to today"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Grant expiry"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["None"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expires_at"]}," on the spec; defaults to 90 days"]}]}]}]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"the-flow"},"children":["The flow"]},{"$$mdtype":"Tag","name":"Mermaid","attributes":{"data-language":"mermaid","diagramSource":"sequenceDiagram\n participant PB as Partner Backend\n participant API as Hubby API\n participant App as Native App
(Hubby SDK)\n\n PB->>API: POST /api/bookings
{ esim_type: 'classic', email or external_user_id, ... }\n API-->>PB: { package_queues: [{ uuid, esim_type, ... }], booking }\n API->>App: FCM push (queue_id, booking_id) — fire-and-forget\n App->>API: list_classic_package_queues (onCall)\n API-->>App: [{ id, package_specification, expires_at }, ...]\n App->>API: set_classic_package_queue_destination
{ queue_id, iso3 } (onCall, optional)\n API-->>App: queue updated\n App->>API: claim_classic_package_queue { queue_id } (onCall)\n API-->>App: { queue, esim_iccid, esim_packages, is_top_up }\n","diagramHtml":"
Native App(Hubby SDK)Hubby APIPartner BackendNative App(Hubby SDK)Hubby APIPartner BackendPOST /api/bookings{ esim_type: 'classic', email or external_user_id, ... }{ package_queues: [{ uuid, esim_type, ... }], booking }FCM push (queue_id, booking_id) — fire-and-forgetlist_classic_package_queues (onCall)[{ id, package_specification, expires_at }, ...]set_classic_package_queue_destination{ queue_id, iso3 } (onCall, optional)queue updatedclaim_classic_package_queue { queue_id } (onCall){ queue, esim_iccid, esim_packages, is_top_up }
"},"children":["sequenceDiagram\n participant PB as Partner Backend\n participant API as Hubby API\n participant App as Native App
(Hubby SDK)\n\n PB->>API: POST /api/bookings
{ esim_type: 'classic', email or external_user_id, ... }\n API-->>PB: { package_queues: [{ uuid, esim_type, ... }], booking }\n API->>App: FCM push (queue_id, booking_id) — fire-and-forget\n App->>API: list_classic_package_queues (onCall)\n API-->>App: [{ id, package_specification, expires_at }, ...]\n App->>API: set_classic_package_queue_destination
{ queue_id, iso3 } (onCall, optional)\n API-->>App: queue updated\n App->>API: claim_classic_package_queue { queue_id } (onCall)\n API-->>App: { queue, esim_iccid, esim_packages, is_top_up }\n"]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-1--create-a-booking-server-side"},"children":["Step 1 — Create a Booking (server-side)"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /api/bookings"]}," you use for traditional bookings, with one classic-tagged spec:"]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"bash","header":{"controls":{"copy":{}}},"source":"curl --request POST \\\n 'https://api.hubbyesim.com/api/bookings' \\\n --header 'x-api-key: YOUR_API_KEY' \\\n --header 'x-timestamp: 1779359116000' \\\n --header 'x-signature: YOUR_HMAC_SIGNATURE' \\\n --header 'Content-Type: application/json' \\\n --data '{\n \"email\": \"traveler@example.com\",\n \"package_specifications\": [\n {\n \"esim_type\": \"classic\",\n \"email\": \"traveler@example.com\",\n \"destination\": \"ESP\",\n \"size\": \"1GB\",\n \"package_type\": \"data-limited\"\n }\n ]\n }'\n","lang":"bash"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Notable defaults applied server-side when a spec is classic:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["departure_date"]}," defaults to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["today"]}," when omitted (skeletal Booking for non-travel grants)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expires_at"]}," on the spec defaults to ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["today + 90 days"]}," when omitted."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["esim_type"]}," defaults to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["universal"]}," when omitted — set it explicitly to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["classic"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Response:"]}]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"{\n \"success\": true,\n \"data\": {\n \"id\": \"iVlU7xgTCUq0537I9GpH\",\n \"package_queues\": [\n {\n \"uuid\": \"fe17e0ef-0cd3-4c2f-8e27-8cbaca0bde29\",\n \"destination\": \"Spain\",\n \"iso3\": \"ESP\",\n \"esim_type\": \"classic\"\n }\n ]\n }\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Persist the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package_queues[].uuid"]}," if you want to correlate with webhook events later."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Re-submitting is idempotent."]}," Because classic grants are user-keyed (by per-spec ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["email"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["external_user_id"]},"), re-submitting with the same ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booking_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["departure_date"]},", and partner ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["merges"]}," any new grants into the existing booking and skips ones already queued for that user — so retries are safe and you can add a second grant later. See ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/openapi"},"children":["Re-submitting a booking"]}," on ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["POST /bookings"]},"."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"step-2--user-claims-via-the-native-app"},"children":["Step 2 — User claims via the native app"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Three Firebase v2 callable functions, exposed through the Hubby SDK. All require a Firebase-authenticated User (the App Check enforcement is on)."]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"list_classic_package_queues"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["list_classic_package_queues"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returns the calling User's ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["unclaimed, unexpired"]}," classic queues."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"// Response shape\n{\n \"queues\": [\n {\n \"id\": \"fe17e0ef-0cd3-4c2f-8e27-8cbaca0bde29\",\n \"package_specification\": {\n \"esim_type\": \"classic\",\n \"size\": \"1GB\",\n \"iso3\": \"ESP\",\n \"destination\": \"Spain\",\n \"package_type\": \"data-limited\"\n },\n \"expires_at\": \"2026-08-19T10:22:54.528Z\",\n \"redeemed_at\": null\n }\n ]\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"set_classic_package_queue_destination"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["set_classic_package_queue_destination"]}," ",{"$$mdtype":"Tag","name":"em","attributes":{},"children":["(only when iso3 is unset)"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Use when the partner created the grant without picking a destination — the User selects one in your UI, then you call this endpoint. Validates the iso3 against the active-Destinations list (per ADR 0002), idempotent overwrite is supported."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"// Request\n{ \"queue_id\": \"fe17e0ef-0cd3-4c2f-8e27-8cbaca0bde29\", \"iso3\": \"ESP\" }\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Error codes:"]},{"$$mdtype":"Tag","name":"div","attributes":{"className":"md-table-wrapper"},"children":[{"$$mdtype":"Tag","name":"table","attributes":{"className":"md"},"children":[{"$$mdtype":"Tag","name":"thead","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Code"},"children":["Code"]},{"$$mdtype":"Tag","name":"th","attributes":{"data-label":"Cause"},"children":["Cause"]}]}]},{"$$mdtype":"Tag","name":"tbody","attributes":{},"children":[{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid-argument"]}," (400)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iso3"]}," could not be resolved, or the destination is inactive, or the queue is not classic-typed"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["not-found"]}," (404)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Queue doesn't exist or doesn't belong to the calling User"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed-precondition"]}," (409)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Queue has already been claimed"]}]},{"$$mdtype":"Tag","name":"tr","attributes":{},"children":[{"$$mdtype":"Tag","name":"td","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["failed-precondition"]}," (410)"]},{"$$mdtype":"Tag","name":"td","attributes":{},"children":["Queue has expired (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["expires_at"]}," past)"]}]}]}]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"claim_classic_package_queue"},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["claim_classic_package_queue"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Provisions a new classic eSIM ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["or"]}," attaches the new package to an existing matching one (same Destination + same IMSI on the destination's package template). The match check is automatic — the response's ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_top_up"]}," flag tells you which path ran."]},{"$$mdtype":"Tag","name":"CodeBlock","attributes":{"data-language":"json","header":{"controls":{"copy":{}}},"source":"// Request\n{ \"queue_id\": \"fe17e0ef-0cd3-4c2f-8e27-8cbaca0bde29\" }\n\n// Response shape\n{\n \"queue\": { /* updated queue, redeemed_at set, esim populated */ },\n \"esim_iccid\": \"8901234567890123456\",\n \"esim_packages\": [ /* dashboard-visible packages on the eSIM */ ],\n \"is_top_up\": false\n}\n","lang":"json"},"children":[]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Same error codes as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["set_destination"]},", plus ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["invalid-argument"]}," (400) when the queue has no destination set yet (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["iso3"]}," is null)."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"why-some-claims-become-top-ups"},"children":["Why some claims become top-ups"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["When a User has an existing ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["non-archived"]}," classic eSIM whose ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["imsi"]}," matches the IMSI on the destination's package template and whose provider matches the bundle's provider, the claim attaches the new EsimPackage to that existing eSIM instead of provisioning a new one. The User keeps the same physical SIM profile on their device; only an additional package is added."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This is ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not a top-up in the glossary sense"]}," — that term is reserved for Stripe-paid additions. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["topup.completed"]}," partner webhook does ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," fire on a classic-grant claim. The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_top_up"]}," flag in the response is purely informational so your UI can phrase the success screen appropriately (\"eSIM ready\" vs \"Package added to your existing eSIM\")."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Matching rules:"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Most-recently-assigned candidate wins when multiple match (by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["time_assigned"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Provider mismatch disqualifies the match (different IMSI plan space)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["A ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["null"]}," IMSI on the destination's template skips matching entirely — the claim always provisions a new eSIM."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"webhooks"},"children":["Webhooks"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Classic grants emit the same booking-level webhooks as other flows (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booking.created"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booking.updated"]},"). The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["package_queues[].uuid"]}," in the booking response is the stable identifier for correlation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["On claim, the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["classic_package_queue.claimed"]}]}," webhook fires (opt-in via ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["webhook_settings.events.classic_package_queue_claimed"]},"). The payload carries ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["queue_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["booking_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["esim_iccid"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["user_id"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["partner_id"]},", and an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_top_up"]}," flag indicating whether the eSIM was freshly provisioned or attached to an existing matching one. See the ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/openapi#operation/ClassicPackageQueueClaimed"},"children":["API reference"]}," for the full schema."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["topup.completed"]}," webhook does ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["not"]}," fire for classic-grant claims — that event is reserved for Stripe-paid additions."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"related"},"children":["Related"]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/native-api"},"children":["Universal Native Integration"]}," — for partners centralising on one ICCID per traveler."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/webview"},"children":["Hubby WebView"]}," — drop-in webview alternative to the Native Integration."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/guides/advanced-topics/multi-destination"},"children":["Multi-destination bookings"]}," — fan-out semantics for array destinations apply to classic grants too."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"a","attributes":{"href":"/apis/openapi#operation/createBooking"},"children":["API reference: POST /bookings"]}," — full request schema."]}]}]},"headings":[{"value":"Classic eSIM Grants","id":"classic-esim-grants","depth":1},{"value":"How it differs from the universal-eSIM flow","id":"how-it-differs-from-the-universal-esim-flow","depth":2},{"value":"The flow","id":"the-flow","depth":2},{"value":"Step 1 — Create a Booking (server-side)","id":"step-1--create-a-booking-server-side","depth":2},{"value":"Step 2 — User claims via the native app","id":"step-2--user-claims-via-the-native-app","depth":2},{"value":"list_classic_package_queues","id":"list_classic_package_queues","depth":3},{"value":"set_classic_package_queue_destination","id":"set_classic_package_queue_destination","depth":3},{"value":"claim_classic_package_queue","id":"claim_classic_package_queue","depth":3},{"value":"Why some claims become top-ups","id":"why-some-claims-become-top-ups","depth":2},{"value":"Webhooks","id":"webhooks","depth":2},{"value":"Related","id":"related","depth":2}],"frontmatter":{"title":"Classic eSIM Grants","description":"Grant a traveler a single-IMSI eSIM that they claim from your native app — an alternative to the universal-eSIM Native Integration","seo":{"title":"Classic eSIM Grants"}},"lastModified":"2026-06-05T10:57:13.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/guides/classic-esim-grants","userData":{"isAuthenticated":false,"teams":["anonymous"]}}