PressOne eSIM Developer Platform
  1. Manage eSIMs
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
        • 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
          • Get eSIM package history
            GET
    • Voice-only eSIM
      • Getting Started
      • Error handling
      • Endpoints
        • List Available Numbers
        • Claim Number
        • Renew Number
        • List User
  1. Manage eSIMs

Get eSIM package history

GET
/customer/v2/sims/{iccid}/packages
💡
GDPR and Data Storage
For compliance with GDPR and global privacy regulations, PressOne does not store any of your end-users' personally identifiable information (PII). You are solely responsible for handling and storing all customer data on your end.
Associating eSIMs with Customers
To retrieve or manage all eSIMs associated with a specific customer, you must store and map the customer's data to the ICCID within your own system. The ICCID is the primary identifier for managing an eSIM post-purchase.
This endpoint comes with a Rate Limit: you can pull specific eSIM history info once every 15 minutes. If you send another request too soon, the server's going to respond with a 429 HTTP code. Please check the 'Retry-After' header, it'll tell you how many seconds to wait before the rate limit resets and you can fetch fresh info.
Please, use a caching mechanism on the client side to deal with frequent customer requests.
To get and display this eSIM’s data package history, including top-ups:
Make a GET request to the endpoint URL: /v1/sims/:iccid/packages, replacing :iccid with the ICCID of the eSIM for which you want to retrieve top-up package information.
The API will respond with a JSON object containing an array of purchased top-up packages for the eSIM, each of which includes an ID, remaining data amount, activation and expiration dates, and other information.

Request

Path Params

Header Params

Responses

🟢200eSIM: List purchased top-up packages (history): 200 OK
application/json
Body

🟠429eSIM: List purchased top-up packages (history): 429 (Rate Limit)
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request GET 'https://prod.your-api-server.com/customer/v2/sims/8910300000005271146/packages' \
--header 'Accept: application/json' \
--header 'Authorization: Bearer {{token}}'
Response Response Example
200 - Success
{
  "success": true,
  "code": "PACKAGE_HISTORY_RETRIEVED",
  "message": "Package history retrieved successfully",
  "data": {
    "data": [
      {
        "id": 1,
        "status": "active",
        "remaining": 500,
        "activated_at": "2024-01-15T10:30:00Z",
        "expired_at": "2024-01-22T10:30:00Z",
        "finished_at": null,
        "package": {
          "id": "5e0db",
          "type": "initial",
          "price": 9.50,
          "net_price": 7.50,
          "amount": 1024,
          "day": 7,
          "is_unlimited": false,
          "title": "Merhaba - 7 Days - 1GB",
          "data": "1 GB",
          "short_info": null
        }
      },
      {
        "id": 2,
        "status": "expired",
        "remaining": 0,
        "activated_at": "2024-01-08T10:30:00Z",
        "expired_at": "2024-01-15T10:30:00Z",
        "finished_at": "2024-01-15T10:30:00Z",
        "package": {
          "id": "topup-abc123",
          "type": "topup",
          "price": 5.00,
          "net_price": 4.00,
          "amount": 512,
          "day": 7,
          "is_unlimited": false,
          "title": "Top-up - 7 Days - 500MB",
          "data": "500 MB",
          "short_info": null
        }
      }
    ]
  },
  "timestamp": "2025-10-29T12:30:00.000Z"
}
Modified at 2025-11-16 23:24:10
Previous
Get eSIMs list
Next
Getting Started
Built with