1. Product Information
Airalo Partner API
  • OVERVIEW
    • Introduction
    • Attribute descriptions
    • FAQ
    • Developer feedback
    • Quick start
      • Step 1: Request access token
      • Step 2: Get packages
      • Step 3: Submit order
      • Step 4: Get installation instructions
    • Guides
      • How to set up a brand for eSIMs Cloud link sharing
      • How to get the eSIMs Cloud sharing link through API
      • How to generate the QR code for an eSIM
      • eSIM installation methods for API Partners
  • REST API
    • Introduction
    • Rate limits
    • Error handling
    • Go live checklist
    • Sandbox mode
    • Endpoints
      • Authenticate
        • Request access token
      • Browse packages
        • Get packages
      • Request refund
        • Request refund
      • Place order
        • Future orders
        • Submit order
        • Submit order async
        • eSIM voucher
      • Install eSIM
        • Get eSIM
        • Get installation instructions
      • Monitor usage
        • Get usage (data, text & voice)
      • Top up eSIM
        • Get top-up package list
        • Submit top-up order
      • Manage orders
        • Get order list
        • Get order
        • Cancel future orders
        • Future Orders
      • Manage eSIMs
        • Update eSIM brand
        • Get eSIMs list
        • Get eSIM package history
      • Compatible devices
        • [Deprecated] Get compatible device list
        • Get compatible device lite list
      • Notifications
        • Airalo webhooks opt-in and flow
        • Webhooks guide
        • Webhook definition
        • Notification: Low data
          • Opt in
          • Get notification details
          • Opt out
        • Notification: Credit limit
          • Opt in
          • Get notification details
          • Opt out
        • Notification: Async orders
          • Opt in
          • Get notification details
          • Opt out
        • Webhook simulator
      • Check balance
        • Get balance
      • Product Information
        • Get Product Information (PIB)
          GET
  • SDKs
    • Introduction
    • SDK vs. REST API
    • Technical notes
  • WOOCOMMERCE PLUGIN
    • Introduction
    • Guides
      • How to install the Airalo Plugin for WooCommerce
      • How to customize the "My eSIMs" page colors in WooCommerce
      • How to convert prices into your local currency
  • Whitelabel eSIM platform
    • Whitelabel eSIM platform integration guide
  1. Product Information

Get Product Information (PIB)

GET
/v2/packages/{package_slug}/product-information
💡
This endpoint comes with a Rate Limit: 60 requests per minute per company and per unique package.
Overview
Retrieve the standardized Product Information for a single eSIM package on the Airalo Partners API. Pass the package's package_slug in the path and the endpoint returns a structured, regulator-ready summary of that package — services included, data allowance, validity, speeds, pricing, throttling/fair-usage rules, and the partner & legal entity details — along with a versioned, downloadable Product Information Brochure (PIB) PDF.
This endpoint is designed to help you surface a clear, consistent product summary to your end customers (and to meet pre-sale transparency requirements) without assembling those details yourself from the packages catalogue.

Features#

Single package lookup: Returns the full product information for one package, identified by its package_slug.
Versioning: Every response carries a pib_version, pib_version_date, and a version_hash. When a package's underlying details change, a new version is generated automatically; if nothing has changed, the same version and hash are returned (idempotent).
Downloadable brochure: pib_version_pdf_link provides a link to the generated Product Information Brochure (PDF) for the current version.
Throttling & fair-usage transparency: is_fair_usage_policy, fair_usage_policy, throttle speeds, and throttle_threshold_mb describe any usage restrictions on unlimited packages.

How to use this endpoint#

Make a GET request to this endpoint and provide the package_slug of the package you want product information for (e.g. change-7days-1gb).
Include the required authentication header: Authorization: Bearer <ACCESS_TOKEN> (Refer to Request access token).
The API responds with a single JSON object containing the package's product attributes, versioning metadata, partner/legal details, and a link to the generated PDF brochure.

Response highlights#

Service flags: service_internet, service_telephony, service_sms indicate which services the package includes.
Allowance & validity: data_allowance_mb, data_allowance_display, validity_days, voice_minutes, sms_included, and is_unlimited.
Network: network_providers and network_technologies (e.g. 4G/5G) describe coverage and supported technology.
Speeds: max_download_speed_mbit, max_upload_speed_mbit, and the throttled equivalents after the fair-usage threshold is reached.
Pricing: retail_price_eur and out_of_bundle_rate_eur_per_mb.
Legal & partner info: partner_brand_name, partner_logo_url, legal_entity_name, legal_address, terms_url, and auto_renewal.
Note
An invalid or unknown package_slug returns a 404 Not Found.
For unlimited packages, allowance fields may default to Unbegrenzt and should be interpreted alongside is_unlimited and the fair-usage fields rather than shown as a literal limit.

Request

Path Params

Header Params

Request Code Samples

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://partners-api.airalo.com/v2/packages/change-in-3days-unlimited/product-information' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{token}}' \
--header 'url: https://partners-api.airalo.com'

Responses

🟢200Success
application/json
Bodyapplication/json

Example
{
    "data": {
        "package_id": "change-in-3days-unlimited",
        "product_name": "Unbegrenzt - 3 Tage",
        "product_description": "Unbegrenzt - 3 Tage",
        "date_marketed": null,
        "service_internet": true,
        "service_telephony": false,
        "service_sms": false,
        "network_providers": [
            "T-Mobile",
            "Verizon"
        ],
        "network_technologies": [
            "5G"
        ],
        "data_allowance_mb": "Unbegrenzt",
        "data_allowance_display": "Unbegrenzt",
        "validity_days": 3,
        "voice_minutes": 0,
        "sms_included": 0,
        "retail_price_eur": "10.12",
        "max_download_speed_mbit": "20000",
        "max_upload_speed_mbit": "10000",
        "throttled_download_speed_mbit": "1 Mbps",
        "throttled_upload_speed_mbit": "1 Mbps",
        "throttle_threshold_mb": 3072,
        "is_unlimited": true,
        "is_fair_usage_policy": true,
        "fair_usage_policy": "Geringere Geschwindigkeit von 1 Mbps nach 3 GB Verbrauch pro Tag.",
        "out_of_bundle_rate_eur_per_mb": "Out of bundle rate is not applicable",
        "activation_policy": "first-usage",
        "is_roaming": true,
        "auto_renewal": "Das Paket verlängert sich nicht automatisch",
        "terms_url": "https://airalo.com/de/more-info/terms-conditions",
        "partner_brand_name": "Airalo",
        "partner_logo_url": "https://cdn-revamp.airalo.com/img/logo-homepage-header.png",
        "legal_entity_name": "AirGSM PTE. LTD.",
        "legal_address": "6 Raffles Boulevard, Justco @ Marina Square, #03-308, Singapore, 039594",
        "pib_version": 1,
        "pib_version_date": "2026-06-29T11:34:59+00:00",
        "version_hash": "59b0dfc6ebecf7eb913ee382a10eb4c648b49260824a51baffe27ea04f203453",
        "pib_version_pdf_link": "https://assets.partners.airalo.com/package_versions/change-in-3days-unlimited/1.pdf"
    }
}
🟠404Not found
🟠429Too Many Requests
🟠403Forbidden
Modified at 2026-06-30 11:49:02
Previous
Get balance
Next
Introduction
Built with