Get eSIM package history

💡

This endpoint comes with a Rate Limit: 10 requests per minute per unique ICCID.

Note for unlimited packages

For unlimited packages the remaining, total and amount fields will default to 0 should be ignored, and not displayed to the end users.

When in Sandbox mode, the is_unlimited field can be false for an unlimited package ordered, due to not having real eSIMs available, thus don't reflect real usage.

GDPR and Data Storage
For compliance with GDPR and global privacy regulations, Airalo 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.

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 request to GET eSIM package history, providing the iccid of the eSIM for which you want to retrieve top-up package for.

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 relevant information.

For more information and best practices visit our FAQ page

{ "pricing": { "model": "net_pricing", "discount_percentage": 0 }, "data": [ { "id": 728, "status": "ACTIVE", "remaining": 2378, "activated_at": "2023-01-09T10:30:45+00:00", "expired_at": "2023-02-09T10:30:45+00:00", "finished_at": null, "package": { "id": "bonbon-mobile-30days-3gb-topup", "type": "topup", "price": 10, "net_price": 6, "amount": 3072, "day": 30, "is_unlimited": false, "title": "3 GB - 30 Days", "data": "3 GB", "short_info": null } }, { "id": 725, "status": "ACTIVE", "remaining": 2496, "activated_at": "2023-01-09T10:30:45+00:00", "expired_at": "2023-02-09T10:30:45+00:00", "finished_at": null, "package": { "id": "bonbon-mobile-30days-3gb-topup", "type": "topup", "price": 10, "net_price": 6, "amount": 3072, "day": 30, "is_unlimited": false, "title": "3 GB - 30 Days", "data": "3 GB", "short_info": null } } ] }

Request

Responses