List eSIM location events
Lists the networks and locations where an eSIM registered, newest first.
Lists the networks and locations where an eSIM registered, newest first.
Returns { items, pagination }, one item per registration with its MCC, MNC, location, network and
occurredAt. from and to limit the events by occurredAt, both inclusive. An ICCID that
is not one of your eSIMs gives 404 / 10004.
PartnerApiKeyX-Partner-Key<token>Partner API Key (X-Partner-Key)
iccid*stringThe eSIM's ICCID, from the order item's fulfillment.result.details.iccid.
page?integerPage number, from 1; default 1.
int321limit?integerPage size, 1 to 100; default 10.
int3210from?stringOnly events that occurred at or after this UTC time. ISO 8601 date-time. A value with Z or an offset is converted to UTC; a value without a zone is read as UTC, and a date alone means 00:00 UTC on that day.
date-timeto?stringOnly events that occurred at or before this UTC time. ISO 8601 date-time. A value with Z or an offset is converted to UTC; a value without a zone is read as UTC, and a date alone means 00:00 UTC on that day.
date-timeOK
- response
A page of the networks an eSIM registered on, newest first.
items*array<>pagination*Paging of a list response.
curl -X GET 'https://api.sandbox.openroam.com/v1/esims/8944501234567890123/location-events?page=1&limit=10&from=2026-10-01T00%3A00%3A00Z&to=2026-10-31T23%3A59%3A59Z'{ "items": [ { "iccid": "string", "mcc": 0, "mnc": 0, "location": "string", "network": "string", "occurredAt": "2019-08-24T14:15:22Z" } ], "pagination": { "currentCount": 0, "totalCount": 0, "skip": 0, "limit": 0, "hasMore": true, "page": 0, "totalPages": 0 }}Get an eSIM GET
Returns one of your eSIMs by its ICCID, with its installation details, plan and top-ups. Returns the eSIM as last recorded, without a live refresh: `esimStatus` and `profileStatus` as the order item names them, the SIM details (LPA code, QR code URL and quick-install links), the plan, its data (MB), SMS (messages) and voice (minutes) allowances, any top-ups, and `expiresAt`, null until the eSIM is activated. An ICCID that is not one of your eSIMs gives 404 / 10004.
List eSIM status events GET
Lists the status changes of an eSIM, newest first. Returns `{ items, pagination }`, one item per status change with `esimStatus`, `profileStatus` and `occurredAt`. `from` and `to` limit the events by `occurredAt`, both inclusive. An ICCID that is not one of your eSIMs gives 404 / 10004.