Get eSIM package history

💡

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.

{ "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" }

Request

Responses