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

Body

🟢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)

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

{ "data": [ { "slug": "nisi velit sit", "country_code": "MG", "title": "psst since beneath which orange screw solace supplier gee huzzah", "image": { "width": -8764884, "height": -44649928, "url": "https://youthful-dependency.info/" }, "operators": [ { "id": 100, "style": "aliquip", "gradient_start": "consequat esse exercitation sunt commodo", "gradient_end": "irure", "type": "minim dolor ullamco sit Ut", "is_prepaid": true, "title": "provided neaten gosh whereas smug truthfully terrorise blah unexpectedly", "esim_type": "in labore fugiat", "warning": null, "apn_type": "est pariatur", "apn_value": null, "is_roaming": false, "info": [ "adipisicing deserunt Duis", "in nulla ut aliquip" ], "image": { "width": 86223279, "height": 1207940, "url": "https://hospitable-tributary.org/" }, "plan_type": "consectetur pariatur anim sint nulla", "activation_policy": "nostrud", "is_kyc_verify": false, "rechargeability": false, "other_info": "adipisicing", "coverages": [ { "name": "Irma O'Conner", "code": "60", "networks": [ { "name": "Kara Towne", "types": [ "in deserunt laborum dolore sunt", "consequat ex ad", "ut eiusmod" ] } ] } ], "install_window_days": 43997313, "topup_grace_window_days": null, "apn": { "ios": { "apn_type": "sed exercitation do", "apn_value": "esse" }, "android": { "apn_type": "in ipsum in ut", "apn_value": "do in et" } }, "packages": [ { "id": "39", "type": "in in Duis consequat", "price": 594.29, "amount": 77, "day": -3890086, "is_unlimited": true, "title": "duh perfectly blissfully first anaesthetise always interviewer before", "short_info": null, "qr_installation": "ad", "manual_installation": "in", "is_fair_usage_policy": false, "fair_usage_policy": "ad adipisicing do anim cupidatat", "data": "consectetur id", "voice": 27234892, "text": null, "net_price": 57.19, "prices": { "net_price": { "AUD": -13696303, "BRL": -15283800.771969423, "GBP": -32428471.334462866, "CAD": 5133145.721630767, "AED": -44590792.98985009, "EUR": 5753824, "INR": -56465579.26247509, "IDR": -72764097, "ILS": -3363217.52255255, "JPY": -72053278, "MYR": 74456275.18231541, "MXN": -64399389.820158385, "SGD": -58957408.57563565, "KRW": 88820764, "USD": 736282, "VND": 97588753 } } }, { "id": "88", "type": "mollit",

Features#

Rate Limit#

Multi-Currency#

Important Notes#

Request

Responses

Features

Rate Limit

Multi-Currency

Important Notes