eSIM voucher - Airalo Developer Platform

Overview:
The eSIM voucher endpoint lets you purchase Airalo eSIM activation codes individually or in bulk. You can store these codes as inventory and distribute them to customers through your own channels (e.g., website, app, email, CRM). Customers redeem the code on the Airalo app or Airalo website to install and activate the eSIM.

Why choose vouchers:
Vouchers offer a fast go‑to‑market path to provide connectivity without implementing a full eSIM purchase and management flow. You can offer connectivity through eSIM vouchers or Airmoney vouchers, while Airalo provides 24/7 customer support in 53 languages, has a 90+ CSAT score, and takes full responsibility and liability for connectivity.

How to use this endpoint:
This endpoint is a good fit if you want to resell eSIMs (buy codes at partner rates and set your own pricing), embed voucher fulfillment into your customer journey (e.g., post‑purchase delivery), or manage inventory by buying in bulk and distributing codes on demand. For order reconciliation, you can pass an optional booking_reference to link each purchase to your internal order ID. Requests are sent as an array of voucher items—each specifying a package_id and quantity—and the response returns activation codes you can deliver to your customers.

This endpoint allows you to create an esim voucher to the Airalo Partners API. Provide the required information, such as quantity and package ID. 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.

Body structure:

{
    "vouchers": [
        {
            "package_id": "replace with actual package slug",
            "quantity": 3,
            "booking_reference": "123"
        }
    ]
}

Request parameters:

vouchers (array, required):

An array of voucher objects to be created for eSIMs. Each voucher object contains the following fields:

package_id (string, required):

The unique identifier (slug) of the eSIM package for which the voucher is being issued.

Example: "package_id": "eu-europe-5gb-30days"

quantity (integer, required):

The number of vouchers you wish to purchase for the specified package.

Example: "quantity": 3

booking_reference (string, optional):

A field used to store the booking reference for this voucher, which can be used for tracking purposes in your own system.

Example: "booking_reference": "123"

If not provided, this field will be ignored.

Request Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

Responses

🟢200Esim voucher

text/plain

Examples

Esim voucherEsim voucher error

{
    "data": [
        {
            "package_id": "jaco-mobile-7days-1gb",
            "codes": [
                "BIXLAAAA",
                "BSXLAAAA"
            ],
            "booking_reference": "123"
        },
        {
            "package_id": "liberation-mobile-30days-3gb",
            "codes": [
                "1HKGDUMP"
            ],
            "booking_reference": "123"
        }
    ],
    "meta": {
        "message": "success"
    }
}

🟢200Esim voucher error