List allocated eSIMs
GET/v1/esims
Returns a page of the eSIMs allocated to you, newest first.
Rows are EsimSummary, which leaves out two fields on purpose.
packages is one: an eSIM accumulates them as it is topped up, and
inlining every one on every row turns a page into a payload nobody
asked for.
activation_code is the other, and for a different reason. Each one
installs a profile, so a page of a hundred would be a hundred secrets
in a single response — easy to log, easy to proxy into a browser,
impossible to take back. Retrieve an eSIM when you need to deliver
its install instructions.
Filter by order_reference to find the eSIM behind one of your
orders, or by iccid when a traveller reads theirs off the handset.
Request
Responses
- 200
- 400
- 401
- 429
A page of eSIMs.
The request is malformed or contains an unrecognized parameter.
Credentials are missing, invalid, or expired. Do not retry.
Rate limit exceeded. Honor Retry-After.
Response Headers
Seconds to wait before retrying.