List eSIM packages
GET/v1/esim/packages
Returns the packages on sale — where each one works, how long it lasts, and what it costs you.
Only status: available is listed. A package we have frozen or
withdrawn is not here, so a storefront can render this response
wholesale without checking each row. To read one anyway — an order
from last month references it — retrieve it by id.
This list is not paginated, and it is not sortable. The catalog is
small and bounded, so the response carries all of it. There is no
limit, no cursor, and no has_more to loop on. Narrow it with
country; sort it yourself — you already hold every row, so a server
round trip to reorder them would buy nothing.
Packages come back ordered by name, ascending. The order is stable,
so two calls with the same filter return the same sequence.
Nothing is provisioned here. A package becomes an eSIM profile only when it is ordered.
volume is in megabytes, and it carries its own type. Read both:
the same 1024 is 1 GB on a total plan and 30 GB on a 30-day
daily one.
The catalog is shared and changes rarely. Cache it and refresh on a timer rather than calling this on every page view.
Request
Responses
- 200
- 400
- 401
- 429
The catalog, in full.
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.