# Get eSIM usage (/docs/api-reference/esims/get-usage)

`GET /v1/esims/{iccid}/usage`

Returns the current data, SMS and voice usage of an eSIM.

Reads the live usage when the request is made and returns `esimStatus`, `profileStatus` and the allowed
and remaining data (MB), SMS (messages) and voice (minutes), including top-ups. An amount is null when it is
unlimited (`isDataUnlimited`, `isSmsUnlimited`, `isVoiceUnlimited`), not reported or not
included. When the usage cannot be read live, or the plan does not report live usage, it returns the last known
usage. An ICCID that is not one of your eSIMs gives 404 / 10004.

## Parameters

| Name | In | Required | Type | Description |
|---|---|---|---|---|
| `iccid` | path | yes | `string` | The eSIM's ICCID, from the order item's `fulfillment.result.details.iccid`. |

## Responses

### 200

OK

- `text/plain`: `EsimCurrentUsage`
- `application/json`: `EsimCurrentUsage`
- `text/json`: `EsimCurrentUsage`

### 400

Invalid partner request or model validation failure.

- `application/json`: `ErrorResponse`

### 401

Unauthorized

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 404

Not Found

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

### 429

Too many requests from this IP address. Wait for Retry-After seconds, then send the same request again; an order keeps its Idempotency-Key and body.

- `application/json`: `ErrorResponse`

### 500

Internal Server Error

- `text/plain`: `ErrorResponse`
- `application/json`: `ErrorResponse`
- `text/json`: `ErrorResponse`

The full schemas are in the OpenAPI specification at /openapi.json.