---
title: "eSIM detail with activation surfaces"
method: GET
path: "/api/v1/esims/{id}"
---

# eSIM detail with activation surfaces

`GET /api/v1/esims/{id}`

## Request

- Base URL: `https://roamzy.io`
- URL: `https://roamzy.io/api/v1/esims/{id}`
- Auth: HTTP bearer

Returns eSIM info plus the activation block (qr_payload — render locally, lpa_url) when status is active or paused.

## Path parameters

- `id` string, required

## Response `200`

OK

- object
  - `esim` object
    - `id` string
    - `display_id` string
    - `status` string
    - `msisdn` string, nullable
    - `iccid` string
    - `balance_usdt` number
  - `activation` object, nullable
    - `qr_payload` string: Raw QR text for clients that render their own QR
    - `lpa_url` string: Universal-activation URL for one-tap install on iOS 17.4+/Android 14+ when agent and target device match

## Other responses

- `401`: Missing or invalid token
- `404`: eSIM not found (or not yours)

---

[API](https://skmtc.dev/roamzy/apis/roamzy-agent-api.md) · [All operations](https://skmtc.dev/roamzy/apis/roamzy-agent-api/llms.txt) · [OpenAPI document](https://skmtc.dev/roamzy/apis/roamzy-agent-api/revisions/8757b8d0b779?raw)