Step 2: Get packages

💡

This endpoint comes with a Rate Limit: 80 requests per minute to fetch packages per unique authentication token.

Retrieve a list of local and global eSIM packages available through the Airalo Partners API. Local packages cover a single country, while global packages span multiple countries and regions. This endpoint helps you synchronize eSIM plans/packages with your system, ensuring newly introduced packages are available to your clients and out-of-stock packages are handled properly.

Features

Package Types: Supports standard data packages and the new "Voice and Text" packages.

Filtering: Filter results by operator type or country code to tailor the package list to your needs.

Pagination: Adjust pagination settings to retrieve results in manageable chunks.

Limit: Set the limit parameter to a high value (e.g., 1,000) to fetch all packages in a single request without using pagination.

Include Top-Up: Use the include:top-up parameter to fetch eSIM packages along with their associated top-up packages.

Multi-Currency

This endpoint provides pricing information in multiple currencies for both net prices and recommended retail prices. All currency conversion rates are updated once daily at 00:00 UTC.

Step-by-step implementation:

To keep your catalog up to date, including stock availability, new packages, and pricing, while avoiding performance or rate-limit issues, it’s important to run an hourly backend sync.
Below, we provide a step-by-step guide to help you successfully sync your packages:

Hourly Sync

Set up a background job via cron, worker, or cloud scheduler that calls GET /v2/packages once every hour.

Include the required authentication header: Authorization: Bearer <ACCESS_TOKEN> (Refer to Request access token)

Single Full Fetch (No Limit Param)

Call the endpoint without a limit parameter to retrieve the full catalogue (~3,200 packages) in a single response. This eliminates pagination and keeps the sync logic straightforward.

Alternatively, you can implement pagination or split sync runs (e.g. alternating between eSIMs and top-ups).

Rate-Limit Context

The API allows up to 40 requests per minute. One request per hour is far below this threshold and safe to run continuously.

Snapshot-Based Processing

Store the returned JSON as a complete snapshot (file, object storage, or database).

Upsert packages using package_id as the unique key.

Remove any packages missing from the latest snapshot.

Sync operators, coverage, pricing, and metadata fields.

Throtlling policy

Identify unlimited packages with usage restrictions by checking the is_fair_usage_policy boolean. If enabled, the fair_usage_policy field contains a string describing the specific limitations.
Example:

"is_fair_usage_policy": true,
"fair_usage_policy": "Lower speed rate of 1 Mbps after 3 GB usage per day."

✍

Got a Minute? We'd love to hear your feedback. Share your thoughts →

application/json

Bodyapplication/json

Examples

List Packages (200)List Packages with topup (200)List Global Packages (200)List Local Packages (200)List Local Packages for Specific Country (200)List Packages with Pagination (200)List Packages with Pagination page>=2 (200)(Discount pricing) List PackagesList Packages (422)

{
    "pricing": {
        "model": "net_pricing",
        "discount_percentage": 0
    },
    "data": [
        {
            "slug": "united-states",
            "country_code": "US",
            "title": "United States",
            "image": {
                "width": 132,
                "height": 100,
                "url": "https://cdn-revamp.airalo.com/images/ad19c2a2-40b8-4dac-b95e-269703c8561b.png"
            },
            "operators": [
                {
                    "id": 1181,
                    "style": "light",
                    "gradient_start": "#0f1b3f",
                    "gradient_end": "#194281",
                    "type": "local",
                    "is_prepaid": false,
                    "title": "Change",
                    "esim_type": "Prepaid",
                    "warning": null,
                    "apn_type": "manual",
                    "apn_value": "wbdata",
                    "is_roaming": true,
                    "info": [
                        "5G Data-only eSIM.",
                        "Rechargeable online with no expiry.",
                        "Operates on T-Mobile, Verizon, and U.S. Cellular networks in the United States of America."
                    ],
                    "image": {
                        "width": 1035,
                        "height": 653,
                        "url": "https://cdn-revamp.airalo.com/images/6bf8859b-3f43-41c7-ac54-434e2534813c.png"
                    },
                    "plan_type": "data",
                    "activation_policy": "first-usage",
                    "is_kyc_verify": false,
                    "rechargeability": true,
                    "other_info": "This eSIM is for travelers to the United States. The coverage includes the United States and Puerto Rico, with limited availability in Alaska.",
                    "coverages": [
                        {
                            "name": "US",
                            "code": "US",
                            "networks": [
                                {
                                    "name": "T-Mobile",
                                    "types": [
                                        "5G"
                                    ]
                                },
                                {
                                    "name": "Verizon",
                                    "types": [
                                        "5G"
                                    ]
                                }
                            ]
                        }
                    ],
                    "install_window_days": 365,
                    "topup_grace_window_days": 180,
                    "apn": {
                        "ios": {
                            "apn_type": "automatic",
                            "apn_value": "wbdata"
                        },
                        "android": {
                            "apn_type": "manual",
                            "apn_value": "wbdata"
                        }
                    },
                    "packages": [
                        {
                            "id": "change-in-3days-unlimited",
                            "type": "sim",
                            "price": 11.5,
                            "amount": 0,
                            "day": 3,
                            "is_unlimited": true,
                            "title": "Unlimited - 3 days",
                            "short_info": null,
                            "qr_installation": "<p><br></p><p><b>eSIM name:</b> Change</p><p><br></p><p><b>Coverage: </b>United States</p><p><br></p><p><b>To 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:</b></p><p><br></p><ol><li>Settings > Cellular/Mobile > Add Cellular/Mobile Plan.</li><li>Scan QR code.</li><li>Confirm eSIM plan details.</li><li>Label the eSIM.</li></ol><p><br></p><p><b>To access Data:</b></p><p><br></p><ol><li>Enable data roaming.</li></ol><p><br></p><p><b>To top up:</b></p><p><br></p><p>Visit airalo.com/my-esims or if purchased through the Airalo website/app visit “My eSIMs” tab.</p><p><br></p><p><br></p><p><br></p><p><br></p><p><br></p><p><br></p><p><br></p><p><br></p><p><br></p><p><br></p><p><br></p><p><br></p><p><br></p><p><br></p><p><br></p>",
                            "manual_installation": "<p><br></p><p><b>eSIM name:</b> Change</p><p><br></p><p><b>Coverage: </b>United States</p><p><br></p><p><b>To manually activate the eSIM on your eSIM capable device:</b></p><p><br></p><ol><li>Settings > Cellular/Mobile > Add Cellular/Mobile Plan.</li><li>Manually enter the SM-DP+ Address and activation code.</li><li>Confirm eSIM plan details.</li><li>Label the eSIM.</li></ol><p><br></p><p><b>To access Data:</b></p><p><br></p><ol><li>Enable data roaming.</li></ol><p><br></p><p><b>To top up:</b></p><p><br></p><p>Visit airalo.com/my-esims

Features

Multi-Currency

Step-by-step implementation:

Hourly Sync

Single Full Fetch (No Limit Param)

Rate-Limit Context

Snapshot-Based Processing

Throtlling policy

Request

Request Code Samples

Responses

Step 2: Get packages

Features#

Multi-Currency#

Step-by-step implementation:#

Hourly Sync#

Single Full Fetch (No Limit Param)#

Rate-Limit Context#

Snapshot-Based Processing#

Throtlling policy#

Request

Request Code Samples

Responses

Features

Multi-Currency

Step-by-step implementation:

Hourly Sync

Single Full Fetch (No Limit Param)

Rate-Limit Context

Snapshot-Based Processing

Throtlling policy