PressOne eSIM Developer Platform
  1. Browse packages
PressOne eSIM Developer Platform
  • OVERVIEW
    • Introduction
    • Attribute descriptions
    • FAQ
    • User journeys
      • Top-up Journey
      • Purchase Journey
    • Guides
      • eSIM installation methods for API Partners
      • How to generate the QR code for an eSIM
  • REST API
    • Data / Data + Voice + SMS eSIM
      • Introduction
      • Error handling
      • Endpoints
        • Authenticate
          • Request access token
        • Check balance
          • Get balance
        • Compatible devices
          • Get compatible device lite list
        • Browse packages
          • Get packages
            GET
        • Place order
          • Submit order
        • Install eSIM
          • Get eSIM
          • Get installation instructions
        • Monitor usage
          • Get usage (data, text & voice)
        • Place top up order
          • Get top-up package list
          • Submit top-up order
        • Manage orders
          • Get order list
          • Get order
        • Manage eSIMs
          • Get eSIMs list
          • Get eSIM package history
    • Voice-only eSIM
      • Getting Started
      • Error handling
      • Endpoints
        • List Available Numbers
        • Claim Number
        • Renew Number
        • List User
  1. Browse packages

Get packages

GET
/customer/v2/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.

Request

Query Params

Header Params

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)
Request Request Example
Shell
JavaScript
Java
Swift
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}}'
Response Response Example
200 - List Packages (200)
{
    "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",
        
Modified at 2025-11-17 12:49:52
Previous
Get compatible device lite list
Next
Submit order
Built with