---
title: "List top-ups for an eSIM"
method: GET
path: "/esimply/orders/topups/{iccid}"
tags: ["eSIMply orders"]
---

# List top-ups for an eSIM

`GET /esimply/orders/topups/{iccid}`

## Request

- Base URL: `https://api.liteapi.travel/v3.0`
- URL: `https://api.liteapi.travel/v3.0/esimply/orders/topups/{iccid}`
- Auth: API key in header `X-API-Key`

## Overview

Retrieve top-up packages that can be applied to an existing eSIM identified by ICCID.

## When to Use

- **Top-up UI** - Show add-on data packs for a traveler's active eSIM
- **Upsell after purchase** - Offer more data when usage is low
- **Eligibility check** - Confirm which packages are valid for a given ICCID

## What You Get

- **Top-up packages** - Package IDs, sizes, validity, and prices
- **External package IDs** - Required when submitting a top-up

## Key Features

- **ICCID-scoped**: Returns only packages eligible for that eSIM
- **Currency conversion**: Optional `Currency` header for priced fields
- **Feeds POST /esimply/orders/submit-topup**: Use returned IDs in the top-up submit request

## Path parameters

- `iccid` string, required

## Headers

- `Currency` string

## Response `200`

Top-ups retrieved successfully

- object
  - `data` TopUpPackage[], required
    - `packageId` integer
    - `name` string
    - `dataSizeMb` integer
    - `validityDays` integer
    - `providerId` integer
    - `providerPackageId` integer
    - `price` number
    - `externalPackageId` string
    - `calculatedPrice` integer
    - `rn` integer

## Other responses

- `400`: Invalid ICCID or currency
- `401`: Authentication required
- `403`: eSIMply access not enabled for this account
- `404`: Order not found for ICCID

---

[API](https://skmtc.dev/liteapi/apis/api-esimply.md) - [All operations](https://skmtc.dev/liteapi/apis/api-esimply/llms.txt) - [OpenAPI document](https://skmtc.dev/liteapi/apis/api-esimply/revisions/b0fb431f4daf?raw)