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

# Get eSIM data usage by ICCID

`GET /esimply/usage/{iccid}`

## Request

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

## Overview

Retrieve live data usage for an eSIM: remaining allowance, total allowance, expiry, and status.

## When to Use

- **Usage meters** - Show travelers how much data remains
- **Top-up prompts** - Trigger upsell when remaining data is low
- **Status checks** - Confirm whether an eSIM is still active

## What You Get

- **Remaining / total** - Data volumes in MB
- **Expiry** - When the current allowance expires
- **Status** - Current eSIM usage status

## Key Features

- **Live provider data**: Usage is fetched from eSIMply for the given ICCID
- **Lightweight**: No pricing or catalog payload—usage only
- **Pairs with top-ups**: Use remaining data to decide when to offer top-ups

## Path parameters

- `iccid` string, required

## Response `200`

Data usage retrieved successfully

- object
  - `data` DataUsage, required
    - `remaining` integer: Remaining data in MB
    - `total` integer: Total data allowance in MB
    - `expiredAt` string, date-time
    - `status` string

## Other responses

- `400`: Invalid ICCID
- `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)