List the topups of an eSIM
List the topups of one eSIM, newest first.
GET
/api/v1/esims/bookings/{iccid}/topup-historyEach entry has the shape of a booking with type topup.
The list has no pagination. It is empty when the eSIM has no topup or is not yours. This is the only eSIM endpoint that lists topups; the account history lists them next to the other bookings.
curl https://api.fx-port.com/api/v1/esims/bookings/8900000540463077957/topup-history \
-H "Authorization: Bearer fxp_test_YOUR_KEY"Response200
{
"environment": "sandbox",
"success": true,
"data": [
{
"id": "bd6ff7d7-392f-4d56-8dea-4f0f3dff0af9",
"booking_id": "FX-1793546625391",
"order_id": "20261101-106853",
"status": "confirmed",
"currency": "DZD",
"total_price": 468.84,
"agency_commission": 50.24,
"type": "topup",
"package_name": "1 GB - 7 days",
"iccid": "8900000540463077957",
"customer_email": "[email protected]",
"customer_first_name": "John",
"customer_last_name": "Smith",
"customer_phone": "+15555550123",
"provider_name": "Airalo",
"supplier_id": "airalo",
"created_at": "2026-11-01T15:23:45.424526+00:00",
"updated_at": "2026-11-01T15:23:45.424526+00:00",
"environment": "sandbox"
}
]
}Request
Path parameters
iccidstringrequiredThe eSIM whose topups to list.
Response
200The topups of the eSIM.
successbooleantrue when the list was returned.
dataarray of EsimBookingThe topups of this ICCID, newest first. Empty when there are none or the ICCID is not yours.
Errors
| Status | Code | Example message |
|---|---|---|
| 400 | invalid_iccid | iccid is not a valid ICCID (received '!'). |
The shape of the error body depends on the endpoint. See Errors for every shape and code.