Get eSIM

This endpoint allows you to retrieve the details of a specific eSIM from the Airalo Partners API using the eSIM's ICCID. Note that only eSIM orders made via the API are retrievable via this endpoint. You can include related data in the response by specifying optional parameters.

The access token, obtained from the "Request Access Token" endpoint, should be included in the request.

For more information and best practices visit our FAQ page

direct_apple_installation_url:

Partner API now supports direct installation on iOS devices. With the introduction of Universal Links by Apple, users with iOS 17.4 or higher can directly install eSIMs using a special URL, which can be provided to your end clients if they are using iOS version 17.4 or above.

curl --location '/v2/sims/?include=order%2Corder.status%2Corder.user%2Cshare' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer {{token}}' \ --header 'url: https://partners-api.airalo.com'

{ "data": { "id": 11028, "created_at": "2023-02-27 08:30:14", "iccid": "8944465400000267221", "lpa": "lpa.airalo.com", "imsis": null, "matching_id": "TEST", "qrcode": "LPA:1$lpa.airalo.com$TEST", "qrcode_url": "https://sandbox.airalo.com/qr?expires=1763800214&id=13282&signature=93bc1599eaaea3175eb32a9f23b3961273e97f04c50ba1b57b68ac99bc6677df", "direct_apple_installation_url": "https://esimsetup.apple.com/esim_qrcode_provisioning?carddata=LPA:1$wbg.prod.ondemandconnectivity.com$Y7MRQ886FCDJD4RH", "voucher_code": null, "airalo_code": null, "apn_type": "automatic", "apn_value": null, "is_roaming": true, "confirmation_code": "5751", "order": null, "brand_settings_name": "our perfect brand", "recycled": true, "recycled_at": "2025-05-05 10:52:39", "simable": { "id": 9647, "created_at": "2023-02-27 08:30:14", "code": "20230227-009647", "description": null, "type": "sim", "package_id": "kallur-digital-7days-1gb", "quantity": 1, "package": "Kallur Digital-1 GB - 7 Days", "esim_type": "Prepaid", "validity": "7", "price": "9.50", "data": "1 GB", "currency": "USD", "manual_installation": "eSIM name: Kallur DigitalCoverage: Faroe IslandsTo manually activate the eSIM on your eSIM capable device:1. Settings> Cellular/Mobile> Add Cellular/Mobile Plan.2. Manually enter the SM-DP+ Address and activation code.3. Confirm the eSIM plan details4. Label the eSIM.To access Data:1. Enable data roaming.To top-up:Visit airalo.com/my-esims or \"My eSIMs\" tab in your Airaloo app. ", "qrcode_installation": "eSIM name: Kallur DigitalCoverage: Faroe IslandsTo activate the eSIM by scanning the QR code on your eSIM capable device you need to print or display this QR code on other device:1. Settings> Cellular/Mobile> Add Cellular/Mobile Plan.2. Scan QR code3. Confirm the eSIM plan details4. Label the eSIMTo access Data:1. Enable data roaming", "installation_guides": { "en": "https://sandbox.airalo.com/installation-guide" }, "status": { "name": "Completed", "slug": "completed" }, "user": { "id": 120, "created_at": "2023-02-20 08:41:57", "name": "User Name", "email": "email@domain.com", "mobile": null, "address": null, "state": null, "city": null, "postal_code": null, "country_id": null, "company": "Company Name" }, "sharing": { "link": "https://esims.cloud/our-perfect-brand/a4g5ht-58sdf1a", "access_code": "4812" } } }, "meta": { "message": "succes" } }

Request

Responses