List top-ups for an eSIM

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
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Path Params
string
required

eSIM ICCID

Headers
string

Optional ISO-4217 currency code. When set, priced fields are converted using liteAPI exchange rates only (not forwarded to eSIMply).

Responses

Language
Credentials
Header
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json