---
title: "Get an eSIMply order by ICCID"
method: GET
path: "/esimply/orders/{iccid}"
tags: ["eSIMply orders"]
---

# Get an eSIMply order by ICCID

`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`

## 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

## Path parameters

- `iccid` string, required

## Headers

- `Currency` string

## Response `200`

Order retrieved successfully

- object
  - `data` OrderRecord, required
    - `esimId` integer
    - `packageName` string
    - `dataSizeMb` integer
    - `remainingData` integer
    - `destinationCode` string
    - `destinationName` string
    - `price` number
    - `b2bPrice` number
    - `currency` string
    - `iccid` string
    - `qrCode` string: LPA QR string for eSIM installation
    - `smdpAddress` string
    - `activationCode` string
    - `esimProviderId` integer
    - `externalPackageId` string
    - `validityDays` integer
    - `flag` string
    - `createdAt` string, date-time
    - `startDate` string, date-time
    - `endDate` string, date-time
    - `packageId` integer
    - `status` 'active' | 'expired': eSIM plan status: expired when remaining data is 0 or the end date has passed, otherwise active. Returned on order history (`GET /esimply/orders` and `GET /esimply/orders/{iccid}`); omitted from submit and top-up purchase records.

## 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)