Get packages

💡

Action Required: Synchronize at least once every hour.
This step is vital for ensuring newly introduced packages are available and out-of-stock packages are excluded.

Retrieve a list of local and global eSIM packages available through the PressOne ESIM 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.

Rate Limit

This endpoint allows up to 40 requests per minute. Ensure your implementation respects this limit to avoid rate limit errors.

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.

Important Notes

Include the access token, obtained from the Request Access Token endpoint, in the request headers for authentication.

Responses

🟢200List Packages (200)

application/json

Bodyapplication/json

🟢200List Packages with topup (200)

🟢200List Global Packages (200)

🟢200List Local Packages (200)

🟢200List Local Packages for Specific Country (200)

🟢200List Packages with Pagination (200)

🟢200List Packages with Pagination page>=2 (200)

🟠422List Packages (422)

🟠401Unauthorized

curl --location --globoff 'https://prod.your-api-server.com/customer/v2/packages?filter[type]=global&filter[country]=TR&limit=20&page=1&include=topup&language=en&country_code=US&per-page=20' \ --header 'Accept: application/json' \ --header 'Authorization: Bearer {{token}}'

{ "data": [ { "slug": "brazil", "image": { "url": "https://revampeg.com/images/af67-17f5a3faed88.png", "width": 132, "height": 99 }, "title": "Brazil", "operators": [ { "id": 1124, "apn": { "ios": { "apn_type": "automatic", "apn_value": null }, "android": { "apn_type": "automatic", "apn_value": null } }, "info": [ "" ], "type": "local", "image": { "url": "https://revampeg.com/images/af67-17f5a3faed88.png", "width": 1035, "height": 653 }, "style": "light", "title": "Joia", "warning": null, "apn_type": "automatic", "packages": [ { "id": "joia-7days-1gb", "apn": { "ios": { "apn_type": "automatic", "apn_value": null }, "android": { "apn_type": "automatic", "apn_value": null } }, "day": 7, "data": "1 GB", "text": null, "type": "sim", "price": "5940.00", "title": "1 GB - 7 days", "voice": null, "amount": 1024, "prices": { "net_price": { "AED": 6.61, "AUD": 2.57, "BRL": 9.27, "CAD": 2.56, "EUR": 1.58, "GBP": 1.35, "IDR": 32155, "ILS": 5.35, "INR": 170.39, "JPY": 291, "KRW": 2770, "KWD": 0.558, "MXN": 31.27, "MYR": 7.47, "SGD": 2.32, "USD": 1.8, "VND": 47363, "ZAR": 29.54 } }, "apn_type": "automatic", "apn_value": null, "net_price": "1.80", "short_info": null, "is_unlimited": false, "qr_installation": "eSIM name: JoiaCoverage: BrazilTo 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:<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>To access Data:<ol><li>Locate the APN settings in your settings menu.</li><li>Update the APN to \"globaldata\".</li><li>Enable data roaming.</li></ol>To top up:...", "fair_usage_policy": null, "manual_installation": "eSIM name: JoiaCoverage: BrazilTo manually activate the eSIM on your eSIM capable device:<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>To access Data:<ol><li>Locate the APN settings in your settings menu.</li><li>Update the APN to \"globaldata\".</li><li>Enable data roaming...", "is_fair_usage_policy": null }, { "id": "joia-15days-2gb", "apn": { "ios": { "apn_type": "automatic", "apn_value": null }, "android": { "apn_type": "automatic", "apn_value": null } }, "day": 15, "data": "2 GB", "text": null, "type": "sim", "price": "9900.00", "title": "2 GB - 15 days", "voice": null, "amount": 2048, "prices": { "net_price": { "AED": 11.01, "AUD": 4.29, "BRL": 15.45, "CAD": 4.26, "EUR": 2.64, "GBP": 2.25, "IDR": 53592, "ILS": 8.91, "INR": 283.98, "JPY": 485, "KRW": 4617, "KWD": 0.93, "MXN": 52.11, "MYR": 12.45, "SGD": 3.87, "USD": 3, "VND": 78938, "ZAR": 49.23 } }, "apn_type": "automatic", "apn_value": null, "net_price": "3.00", "short_info": null, "is_unlimited": false, "qr_installation": "eSIM name: JoiaCoverage: BrazilTo 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:<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>To access Data:<ol>....", "fair_usage_policy": null, "manual_installation": "eSIM name: JoiaCoverage: BrazilTo manually activate the eSIM on your eSIM capable device:....", "is_fair_usage_policy": null }, { "id": "joia-30days-3gb", "apn": { "ios": { "apn_type": "automatic", "apn_value": null }, "android": { "apn_type": "automatic", "apn_value": null } }, "day": 30, "data": "3 GB", "text": null, "type": "sim", "price": "14520.00", "title": "3 GB - 30 days", "voice": null, "amount": 3072, "prices": { "net_price": { "AED": 16.15, "AUD": 6.29, "BRL": 22.66, "CAD": 6.25, "EUR": 3.87, "GBP": 3.3, "IDR": 78602, "ILS": 13.07, "INR": 416.5, "JPY": 711, "KRW": 6772, "KWD": 1.364, "MXN": 76.43, "MYR": 18.26, "SGD": 5.68, "USD": 4.4, "VND": 115775, "ZAR": 72.2 } }, "apn_type": "automatic", "apn_value": null, "net_price": "4.40", "short_info": null, "is_unlimited": false, "qr_installation": "eSIM name: JoiaCoverage: BrazilTo 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:<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>To access Data:<ol><li>Locate the APN settings in your settings menu.</li>...", "fair_usage_policy": null, "manual_installation": "eSIM name: JoiaCoverage: BrazilTo manually activate the eSIM on your eSIM capable device:<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....", "is_fair_usage_policy": null }, { "id": "joia-30days-5gb", "apn": { "ios": { "apn_type": "automatic", "apn_value": null }, "android": { "apn_type": "automatic", "apn_value": null } }, "day": 30, "data": "5 GB", "text": null, "type": "sim", "price": "22176.00", "title": "5 GB - 30 days", "voice": null, "amount": 5120, "prices": { "net_price": { "AED": 24.66, "AUD": 9.61, "BRL": 34.61, "CAD": 9.54, "EUR": 5.91, "GBP": 5.04, "IDR": 120047, "ILS": 19.96, "INR": 636.12, "JPY": 1086, "KRW": 10343, "KWD": 2.083, "MXN": 116.73, "MYR": 27.89, "SGD": 8.67, "USD": 6.72, "VND": 176821, "ZAR": 110.28 } }, "apn_type": "automatic", "apn_value": null, "net_price": "6.72", "short_info": null, "is_unlimited": false, "qr_installation": "eSIM name: JoiaCoverage: BrazilTo 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:<ol><li>Settings > Cellular/Mobile > Add Cellular/Mobile Plan.</li><li>Scan QR code....", "fair_usage_policy": null, "manual_installation": "eSIM name: JoiaCoverage: BrazilTo manually activate the eSIM on your eSIM capable device:<ol><li>Settings > Cellular/Mobile > Add Cellular/Mobile Plan.</li><li>Manually enter the SM-DP+ Address and activation code.</li>...", "is_fair_usage_policy": null }, { "id": "joia-30days-10gb", "apn": { "ios": { "apn_type": "automatic", "apn_value": null }, "android": { "apn_type": "automatic", "apn_value": null } }, "day": 30, "data": "10 GB", "text": null, "type": "sim", "price": "31119.00", "title": "10 GB - 30 days", "voice": null, "amount": 10240, "prices": { "net_price": { "AED": 38.46, "AUD": 14.99, "BRL": 53.97, "CAD": 14.88, "EUR": 9.22, "GBP": 7.86, "IDR": 187216, "ILS": 31.13, "INR": 992.04, "JPY": 1693, "KRW": 16129, "KWD": 3.249, "MXN": 182.04, "MYR": 43.49, "SGD": 13.52, "USD": 10.48, "VND": 275756, "ZAR": 171.98 } }, "apn_type": "automatic", "apn_value": null, "net_price": "10.48", "short_info": null, "is_unlimited": false, "qr_installation": "eSIM name: JoiaCoverage: BrazilTo 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:<ol><li>Settings >...", "fair_usage_policy": null, "manual_installation": "eSIM name: JoiaCoverage: BrazilTo manually activate the eSIM on your eSIM capable device:<ol><li>Settings > Cellular/Mobile > Add Cellular/Mobile Plan.</li><li>Manually enter the SM-DP+ Address and activation code.</li>...", "is_fair_usage_policy": null }, { "id": "joia-30days-20gb", "apn": { "ios": { "apn_type": "automatic", "apn_value": null }, "android": { "apn_type": "automatic", "apn_value": null } }, "day": 30, "data": "20 GB", "text": null, "type": "sim", "price": "54763.50", "title": "20 GB - 30 days", "voice": null, "amount": 20480, "prices": { "net_price": { "AED": 67.67, "AUD": 26.37, "BRL": 94.97, "CAD": 26.18, "EUR": 16.23, "GBP": 13.83, "IDR": 329415, "ILS": 54.77, "INR": 1745.53, "JPY": 2980, "KRW": 28380, "KWD": 5.716, "MXN": 320.3, "MYR": 76.53, "SGD": 23.79, "USD": 18.44, "VND": 485205, "ZAR": 302.6 } }, "apn_type": "automatic", "apn_value": null, "net_price": "18.44", "short_info": null, "is_unlimited": false, "qr_installation": "eSIM name: JoiaCoverage: BrazilTo 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:<ol><li>Settings > Cellular/Mobile > Add Cellular/Mobile Plan.</li><li>Scan QR code..... ", "fair_usage_policy": null, "manual_installation": "eSIM name: JoiaCoverage: BrazilTo manually activate the eSIM on your eSIM capable device:<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.....", "is_fair_usage_policy": null } ], "apn_value": null, "countries": [ { "image": { "url": "https://cdn-revamp.eg.com/images/e48e0f4a-d84b-4729-af67-17f5a3faed88.png", "width": 132, "height": 99 }, "title": "Brazil", "country_code": "BR" } ], "coverages": [ { "code": "BR", "name": "BR", "networks": [ { "name": "Claro", "types": [ "5G" ] }, { "name": "TIM", "types": [ "4G" ] } ] } ], "esim_type": "Prepaid", "plan_type": "data", "is_prepaid": false, "is_roaming": true, "other_info": null, "gradient_end": "#91D3B1", "is_kyc_verify": false, "gradient_start": "#ABD6BF", "rechargeability": true, "activation_policy": "first-usage", "install_window_days": null, "topup_grace_window_days": null } ], "country_code": "BR" }, { "slug": "ethiopia", "image": { "url": "https://cdn-revamp.eg.com/images/d6d4186a-5f84-4644-8bab-831b11eee6de.png", "width": 132, "height": 99 }, "title": "Ethiopia", "operators": [ { "id": 1366, "apn": { "ios": { "apn_type": "automatic", "apn_value": null }, "android": { "apn_type": "automatic", "apn_value": null } }, "info": [ "4G Data-only eSIM.", "Operates on the Safaricom network in Ethiopia." ], "type": "local", "image": { "url": "https://cdn-revamp.eg.com/images/972613d4-3f4c-490f-8089-8a9c59c50180.png", "width": 1035, "height": 653 }, "style": "light", "title": "Simien", "warning": null, "apn_type": "automatic", "packages": [ { "id": "simien-in-7days-1gb", "apn": { "ios": { "apn_type": "automatic", "apn_value": null }, "android": { "apn_type": "automatic", "apn_value": null } }, "day": 7, "data": "1 GB", "text": null, "type": "sim", "price": "32076.00", "title": "1 GB - 7 days", "voice": null, "amount": 1024, "prices": { "net_price": { "AED": 39.64, "AUD": 15.44, "BRL": 55.62, "CAD": 15.34, "EUR": 9.5, "GBP": 8.1, "IDR": 192933, "ILS": 32.08, "INR": 1022.33, "JPY": 1745, "KRW": 16622, "KWD": 3.348, "MXN": 187.6, "MYR": 44.82, "SGD": 13.93, "USD": 10.8, "VND": 284176, "ZAR": 177.23 } }, "apn_type": "automatic", "apn_value": null, "net_price": "10.80", "short_info": null, "is_unlimited": false, "qr_installation": "eSIM name: SimienCoverage: EthiopiaTo 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:<ol><li>Settings > Cellular/Mobile > Add Cellular/Mobile Plan.</li><li>Scan the QR code.</li><li>Confirm eSIM plan details.</li><li>Label the eSIM.</li></ol>To access Data: Enable data roaming.To top up:Visit eg.com/my-esims or if purchased through the website/app visit “My eSIMs” tab. ", "fair_usage_policy": null, "manual_installation": "eSIM name: SimienCoverage: EthiopiaTo manually activate the eSIM on your eSIM capable device:<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>To access Data: Enable data roaming.To top up:Visit eg.com/my-esims or if purchased through the website/app visit “My eSIMs” tab. ", "is_fair_usage_policy": null }, { "id": "simien-in-15days-2gb", "apn": { "ios": { "apn_type": "automatic", "apn_value": null }, "android": { "apn_type": "automatic", "apn_value": null } }, "day": 15, "data": "2 GB", "text": null, "type": "sim", "price": "47223.00", "title": "2 GB - 15 days", "voice": null, "amount": 2048, "prices": { "net_price": { "AED": 58.35, "AUD": 22.74, "BRL": 81.88, "CAD": 22.58, "EUR": 13.99, "GBP": 11.92, "IDR": 284040, "ILS": 47.22, "INR": 1505.09, "JPY": 2569, "KRW": 24471, "KWD": 4.929, "MXN": 276.18, "MYR": 65.98, "SGD": 20.51, "USD": 15.9, "VND": 418370, "ZAR": 260.92 } }, "apn_type": "automatic", "apn_value": null, "net_price": "15.90", "short_info": null, "is_unlimited": false, "qr_installation": "eSIM name: SimienCoverage: EthiopiaTo 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:<ol><li>Settings > Cellular/Mobile > Add Cellular/Mobile Plan.</li><li>Scan the QR code.</li><li>Confirm eSIM plan details.</li><li>Label the eSIM.</li></ol>To access Data: Enable data roaming.To top up:Visit eg.com/my-esims or if purchased through the website/app visit “My eSIMs” tab. ", "fair_usage_policy": null, "manual_installation": "eSIM name: SimienCoverage: EthiopiaTo manually activate the eSIM on your eSIM capable device:<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>To access Data: Enable data roaming.To top up:Visit eg.com/my-esims or if purchased through the website/app visit “My eSIMs” tab. ", "is_fair_usage_policy": null }, { "id": "simien-in-30days-3gb", "apn": { "ios": { "apn_type": "automatic", "apn_value": null }, "android": { "apn_type": "automatic", "apn_value": null } }, "day": 30, "data": "3 GB", "text": null, "type": "sim", "price": "67567.50", "title": "3 GB - 30 days", "voice": null, "amount": 3072, "prices": { "net_price": { "AED": 100.19, "AUD": 39.04, "BRL": 140.6, "CAD": 38.77, "EUR": 24.02, "GBP": 20.48, "IDR": 487691, "ILS": 81.08, "INR": 2584.22, "JPY": 4411, "KRW": 42017, "KWD": 8.463, "MXN": 474.2, "MYR": 113.3, "SGD": 35.22, "USD": 27.3, "VND": 718334, "ZAR": 447.99 } }, "apn_type": "automatic", "apn_value": null, "net_price": "27.30", "short_info": null, "is_unlimited": false, "qr_installation": "eSIM name: SimienCoverage: EthiopiaTo 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:<ol><li>Settings > Cellular/Mobile > Add Cellular/Mobile Plan.</li><li>Scan the QR code.</li><li>Confirm eSIM plan details.</li><li>Label the eSIM.</li></ol>To access Data: Enable data roaming.To top up:Visit eg.com/my-esims or if purchased through the website/app visit “My eSIMs” tab. ", "fair_usage_policy": null, "manual_installation": "eSIM name: SimienCoverage: EthiopiaTo manually activate the eSIM on your eSIM capable device:<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>To access Data: Enable data roaming.To top up:Visit eg.com/my-esims or if purchased through the website/app visit “My eSIMs” tab. ", "is_fair_usage_policy": null } ], "apn_value": null, "countries": [ { "image": { "url": "https://cdn-revamp.eg.com/images/d6d4186a-5f84-4644-8bab-831b11eee6de.png", "width": 132, "height": 99 }, "title": "Ethiopia", "country_code": "ET" } ], "coverages": [ { "code": "ET", "name": "ET", "networks": [ { "name": "Safaricom", "types": [ "4G" ] } ] } ], "esim_type": "Prepaid", "plan_type": "data", "is_prepaid": false, "is_roaming": true, "other_info": null, "gradient_end": "#D6561D", "is_kyc_verify": false, "gradient_start": "#B64512", "rechargeability": true, "activation_policy": "first-usage", "install_window_days": null, "topup_grace_window_days": null } ], "country_code": "ET" } ], "meta": { "to": 1972, "from": 1, "path": "https://pressone.esim.ent.pressone.co/customer/v2/packages", "total": 1972, "message": "success", "per_page": 1972, "last_page": 1, "current_page": 1 }, "links": { "last": null, "next": null, "prev": null, "first": null } }

Features#

Rate Limit#

Multi-Currency#

Important Notes#

Request

Responses

Features

Rate Limit

Multi-Currency

Important Notes