# List the topups of an eSIM

> List the topups of one eSIM, newest first.

Endpoint: `GET /esims/bookings/{iccid}/topup-history`

Source: https://fx-port.com/docs/api/list-esim-topup-history

`GET /api/v1/esims/bookings/{iccid}/topup-history`

Requires an API key with **Read** permission; a **Read+Write** key works too.

Each 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.

## Request

### Path parameters

- `iccid` (string, required): The eSIM whose topups to list.

### Example request

```bash
curl https://api.fx-port.com/api/v1/esims/bookings/8900000540463077957/topup-history \
  -H "Authorization: Bearer fxp_test_YOUR_KEY"
```

## Response

### 200: The topups of the eSIM.

- `success` (boolean): `true` when the list was returned.
- `data` (array of EsimBooking): The topups of this ICCID, newest first. Empty when there are none or the ICCID is not yours.

```json
{
  "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": "traveler@example.com",
      "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"
    }
  ]
}
```

## Errors

| Status | Code | Example message |
| --- | --- | --- |
| 400 | `invalid_iccid` | iccid is not a valid ICCID (received '!'). |

See [Errors](https://fx-port.com/docs/errors.md) for every code and how to react.

## Related guides

- [eSIM bookings](https://fx-port.com/docs/esims/bookings.md)