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 language support: Pass on the Accept-language header to get your response translated in the language you prefer. All languages available in Sandbox and production mode are found in our FAQs.

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.

Minimum price per country

Each country entry in the data[] array includes a min_price object, giving the lowest available price for that destination. Use it to render a "from" price on destination cards (e.g. "France — from €4.13") without pulling the full package list and calculating the minimum yourself.

Example:

"min_price": {
  "recommended_retail_price": { "USD": 4.50, "EUR": 4.13 },
  "net_price": { "USD": 2.25, "EUR": 2.06 }
}

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"
            },
            "min_price": {
                "net_price": {
                    "AUD": 2.56,
                    "BRL": 9.18,
                    "GBP": 1.35,
                    "CAD": 2.5,
                    "AED": 6.61,
                    "EUR": 1.55,
                    "INR": 166.1,
                    "IDR": 30634,
                    "ILS": 5.56,
                    "JPY": 286,
                    "KWD": 0.558,
                    "MYR": 7.16,
                    "MXN": 31.41,
                    "SGD": 2.29,
                    "ZAR": 29.57,
                    "KRW": 2662,
                    "USD": 1.8,
                    "VND": 47401
                },
                "recommended_retail_price": {
                    "AUD": 5.68,
                    "BRL": 20.4,
                    "GBP": 3,
                    "CAD": 5.56,
                    "AED": 14.68,
                    "EUR": 3.44,
                    "INR": 369.12,
                    "IDR": 68076,
                    "ILS": 12.36,
                    "JPY": 635,
                    "KWD": 1.24,
                    "MYR": 15.92,
                    "MXN": 69.8,
                    "SGD": 5.08,
                    "ZAR": 65.72,
                    "KRW": 5915,
                    "USD": 4,
                    "VND": 105336
                }
            },
            "operators": [
                {
                    "id": 1180,
                    "title": "Change",
                    "type": "local",
                    "plan_type": "data",
                    "is_roaming": true,
                    "rechargeability": true,
                    "packages": [
                        {
                            "id": "change-in-7days-1gb",
                            "type": "sim",
                            "price": 4,
                            "net_price": 1.8,
                            "amount": 1024,
                            "day": 7,
                            "is_unlimited": false,
                            "title": "1 GB - 7 days",
                            "data": "1 GB",
                            "voice": null,
                            "text": null,
                            "prices": {
                                "net_price": {
                                    "USD": 1.8,
                                    "EUR": 1.55,
                                    "GBP": 1.35
                                },
                                "recommended_retail_price": {
                                    "USD": 4,
                                    "EUR": 3.44,
                                    "GBP": 3
                                }
                            }
                        }
                    ]
                }
            ]
        },
        {
            "slug": "france",
            "country_code": "FR",
            "title": "France",
            "image": {
                "width": 132,
                "height": 99,
                "url": "https://cdn-revamp.airalo.com/images/9753dedb-d495-47cf-b6e4-82e555564743.png"
            },
            "min_price": {
                "net_price": {
                    "AUD": 1.99,
                    "BRL": 7.14,
                    "GBP": 1.05,
                    "CAD": 1.95,
                    "AED": 5.14,
                    "EUR": 1.2,
                    "INR": 129.19,
                    "IDR": 23827,
                    "ILS": 4.33,
                    "JPY": 222,
                    "KWD": 0.434,
                    "MYR": 5.57,
                    "MXN": 24.43,
                    "SGD": 1.78,
                    "ZAR": 23,
                    "KRW": 2070,
                    "USD": 1.4,
                    "VND": 36867
                },
                "recommended_retail_price": {
                    "AUD": 6.39,
                    "BRL": 22.95,
                    "GBP": 3.38,
                    "CAD": 6.26,
                    "AED": 16.52,
                    "EUR": 3.87,
                    "INR": 415.26,
                    "IDR": 76585,
                    "ILS": 13.9,
                    "JPY": 714,
                    "KWD": 1.395,
                    "MYR": 17.91,
                    "MXN": 78.52,
                    "SGD": 5.72,
                    "ZAR": 73.94,
                    "KRW": 6655,
                    "USD": 4.5,
                    "VND": 118502
                }
            },
            "operators": [
                {
                    "id": 826,
                    "title": "Élan",
                    "type": "local",
                    "plan_type": "data",
                    "is_roaming": false,
                    "rechargeability": true,
                    "packages": [
                        {
                            "id": "elan-7days-1gb",
                            "type": "sim",
                            "price": 4.5,
                            "net_price": 1.4,
                            "amount": 1024,
                            "day": 7,
                            "is_unlimited": false,
                            "title": "1 GB - 7 days",
                            "data": "1 GB",
                            "voice": null,
                            "text": null,
                            "prices": {
                                "net_price": {
                                    "USD": 1.4,
                                    "EUR": 1.2,
                                    "GBP": 1.05
                                },
                                "recommended_retail_price": {
                                    "USD": 4.5,
                                    "EUR": 3.87,
                                    "GBP": 3.38
                                }
                            }
                        }
                    ]
                }
            ]
        }
    ],
    "links": {
        "first": "https://partners-api.airalo.com/v2/packages?limit=2&language=en&page=1",
        "last": "https://partners-api.airalo.com/v2/packages?limit=2&language=en&page=107",
        "prev": null,
        "next": "https://partners-api.airalo.com/v2/packages?limit=2&language=en&page=2"
    },
    "meta": {
        "message": "success",
        "current_page": 1,
        "from": 1,
        "last_page": 107,
        "path": "https://partners-api.airalo.com/v2/packages",
        "per_page": "2",
        "to": 2,
        "total": 213
    }
}

Features

Multi-Currency

Minimum price per country

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#

Minimum price per country#

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

Minimum price per country

Step-by-step implementation:

Hourly Sync

Single Full Fetch (No Limit Param)

Rate-Limit Context

Snapshot-Based Processing

Throtlling policy