Get Product Information (PIB)

💡

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 Code Samples

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

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

Features#

How to use this endpoint#

Response highlights#

Request

Request Code Samples

Responses

Features

How to use this endpoint

Response highlights