List eSIM status events
Lists the status changes of an eSIM, newest first.
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.
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 an eSIM's status changes, newest first.
items*array<>pagination*Paging of a list response.
curl -X GET 'https://api.sandbox.openroam.com/v1/esims/8944501234567890123/status-events?page=1&limit=10&from=2026-10-01T00%3A00%3A00Z&to=2026-10-31T23%3A59%3A59Z'{ "items": [ { "iccid": "string", "esimStatus": "new", "profileStatus": "empty", "occurredAt": "2019-08-24T14:15:22Z" } ], "pagination": { "currentCount": 0, "totalCount": 0, "skip": 0, "limit": 0, "hasMore": true, "page": 0, "totalPages": 0 }}List eSIM location events GET
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.
Get eSIM usage by day GET
Returns the current usage of an eSIM with a per-day breakdown. Returns the same summary as `usage` plus `usages`, the per-day consumption entries `{ date, usage, location }` with the data used in MB and `location` null when no country was reported. `usages` is empty when the eSIM's plan does not report a per-day breakdown or it cannot be read.