---
title: "List eSIMply orders"
method: GET
path: "/esimply/orders"
tags: ["eSIMply orders"]
---

# List eSIMply orders

`GET /esimply/orders`

## Request

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

## Overview

Retrieve eSIM order history for the authenticated partner account, with optional filters for destination, date range, and client reference.

## When to Use

- **Partner dashboard** - Show past eSIM purchases and top-ups
- **Support lookup** - Find orders by destination or your `clientReference`
- **Reporting** - Pull order history for a travel date window

## What You Get

- **Order records** - Packages, ICCIDs, pricing, destinations, install metadata, and plan `status` (`active` or `expired`)
- **Filterable history** - Narrow results by destination, dates, or client reference

## Key Features

- **Flexible filters**: `destination`, `startDate`, `endDate`, `clientReference`
- **Currency conversion**: Optional `Currency` header for priced fields
- **Environment-aware**: Sandbox and production histories are separate by API key

## Query parameters

- `destination` string
- `startDate` string, date
- `endDate` string, date
- `clientReference` string

## Headers

- `Currency` string

## Response `200`

Orders 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 filters or currency
- `401`: Authentication required
- `403`: eSIMply access not enabled for this account

---

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