LIliteapi
eSIMply orders

Get an eSIMply order by ICCID

Overview

Retrieve a single eSIM order (purchase details, install metadata, and plan status) using its ICCID.

When to Use

  • Order detail page - Show one eSIM's package, pricing, and QR install data
  • Customer support - Look up a traveler's eSIM by ICCID
  • Re-display QR - Recover LPA / activation details after purchase

What You Get

  • Full order record - Package, destination, prices, ICCID, QR, SM-DP, activation code, and status (active or expired)
  • Lifecycle dates - Created, start, and end timestamps when available

Key Features

  • ICCID lookup: Direct access without scanning the full order list
  • Currency conversion: Optional Currency header for priced fields
  • Not found handling: Returns a not-found error when the ICCID is unknown
get/esimply/orders/{iccid}

Request

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

Path parameters

iccidstring required
Example:89000000000000000001

Headers

Currencystring
Example:EUR

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

Response

Order retrieved successfully

Example response

{
  "data": {
    "esimId": 10001,
    "packageName": "1 GB",
    "dataSizeMb": 1024,
    "remainingData": 1024,
    "destinationCode": "MA",
    "destinationName": "Morocco",
    "price": 3.46,
    "b2bPrice": 3.46,
    "currency": "EUR",
    "iccid": "89000000000000000001",
    "qrCode": "LPA:1$smdp.example.com$EXAMPLEACTIVATIONCODE0001",
    "smdpAddress": "smdp.example.com",
    "activationCode": "EXAMPLEACTIVATIONCODE0001",
    "esimProviderId": 4,
    "externalPackageId": "MA|1024",
    "validityDays": 7,
    "flag": "https://esimply-destinations-flags.s3.us-west-1.amazonaws.com/ma.svg",
    "createdAt": "2026-08-12T16:12:49Z",
    "startDate": "2026-08-20T00:00:00Z",
    "endDate": "2026-08-27T00:00:00Z",
    "packageId": 1,
    "status": "active"
  }
}

Changes

No recorded changes to this operation across all 1 revision of this API.