API Reference
Free SignupLogin to DashboardCustomer Support
  1. API: eSIMply
  2. eSIMply orders

Submit an eSIMply top-up

post
https://api.liteapi.travel/v3.0/esimply/orders/submit-topup

Overview

Apply a top-up package to an existing eSIM in a single request. On success you receive an order response with updated purchase details. Successful top-ups are persisted for the partner account.

When to Use

  • Add more data - Traveler needs additional MB on an existing eSIM
  • Extend connectivity - Apply a package without issuing a new ICCID
  • Safe retries - Resubmit with the same Idempotency-Key after network failures

What You Get

  • Order ID - Provider order identifier for the top-up
  • Purchase details - Updated package, pricing, and eSIM identifiers

Key Features

  • Idempotency: Required Idempotency-Key header for safe retries
  • Currency conversion: Optional Currency header for priced fields
  • Persistent records: Successful top-ups are stored in liteAPI
Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params
string
required
string
required

Package ID as string (provider contract)

string
required
string
required
string
required
string
required
string
required
string
Headers
string

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

uuid
required

Required UUID idempotency key for safe retries of top-up submit.

Responses

Updated about 2 hours ago

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

Updated about 2 hours ago

Did this page help you?