Get packages
GET
/v2/packages
This step is vital for ensuring newly introduced packages are available and out-of-stock packages are excluded.
Features
limit parameter to a high value (e.g., 1,000) to fetch all packages in a single request without using pagination.include:top-up parameter to fetch eSIM packages along with their associated top-up packages.Rate Limit
Important Notes
Request Request Example
Shell
JavaScript
Java
Swift
curl --location -g --request GET '/v2/packages?filter[type]=global&filter[country]=TR&limit=&page=1&include=topup' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{token}}'Response Response Example
200 - List Packages (200)
{
"data": [
{
"slug": "united-states",
"country_code": "US",
"title": "United States",
"image": {
"width": 132,
"height": 99,
"url": "https://cdn.airalo.com/images/600de234-ec12-4e1f-b793-c70860e4545a.png"
},
"operators": [
{
"id": 687,
"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 and Verizon networks in the United States of America."
],
"image": {
"width": 1035,
"height": 653,
"url": "https://cdn.airalo.com/images/030f0576-f611-4eee-bba5-eb90a994c4ff.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 applies to all 50 states of the United States, and Puerto Rico.",
"coverages": [
{
"name": "US",
"code": "US",
"networks": [
{
"name": "T-Mobile",
"types": [
"5G"
]
},
{
"name": "Verizon",
"types": [
"5G"
]
}
]
}
],
"install_window_days": null,
"topup_grace_window_days": null,
"apn": {
"ios": {
"apn_type": "automatic",
"apn_value": "wbdata"
},
"android": {
"apn_type": "manual",
"apn_value": "wbdata"
}
},
"packages": [
{
"id": "change-7days-1gb",
"type": "sim",
"price": 4.5,
"amount": 1024,
"day": 7,
"is_unlimited": false,
"title": "1 GB - 7 Days",
"short_info": "This eSIM doesn't come with a phone number.",
"qr_installation": "<p><b>eSIM name:</b> Change</p><p><b>Coverage: </b>United States</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><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><b>To access Data:</b></p><ol><li>Enable data roaming.</li></ol><p><b>To top up:</b></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>",
"manual_installation": "<p><b>eSIM name:</b> Change</p><p><b>Coverage: </b>United States</p><p><b>To manually activate the eSIM on your eSIM capable device:</b></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><b>To access Data:</b></p><ol><li>Enable data roaming.</li></ol><p><b>To top up:</b></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>",
"is_fair_usage_policy": false,
"fair_usage_policy": null,
"data": "1 GB",
"voice": null,
Request
Query Params
filter[type]
string
optional
Example:
global
filter[country]
string
optional
Example:
TR
limit
string
optional
page
string
optional
If the page is set to 2 or beyond, the response will have different format and contain an object representing the country's index in the list of packages.
Example:
1
include
string
optional
Example:
topup
Header Params
Accept
string
required
Example:
application/json
Authorization
string
required
Example:
Bearer {{token}}
Responses
Modified at 2025-06-19 10:51:34