API ReferenceeSIM
List eSIM Plans
Browse the eSIM plan catalog, priced for your project.
GET/open-api/v1/esim/plans
Returns the purchasable eSIM plan catalog. priceUsd is your price per plan — pricing is
project-specific, so always read it from this endpoint rather than hard-coding.
Recommended integration pattern: fetch the full catalog (omit page/size), cache it locally,
and refresh daily.
Query parameters
countryCodestringqueryISO-2 country filter, e.g. HK. Omit for the full catalog.
pageintegerqueryOptional. Omit both page and size to receive the entire catalog as a single page.
sizeintegerqueryOptional page size, used together with page.
Response
Paginated envelope. When page/size are omitted the response is one page containing everything
(pages: 1, size = total).
totalintegerTotal number of plans.
pagesintegercurrentinteger1-based page number.
sizeintegerrecordsarrayResponse
{
"code": 0,
"message": "SUCCESS",
"data": {
"total": 1512,
"pages": 1,
"current": 1,
"size": 1512,
"records": [
{
"planNo": "epln_b312537653c3a51f00",
"name": "Ukraine 0.49GB",
"limitType": "STANDARD",
"days": 1,
"dataMb": 502,
"countryCode": "UA",
"priceUsd": 92
}
]
}
}