List an eSIM's data packages
/v1/esim/sims/{esim_id}/packagesbird esim packages list <esim-id>curl -X GET "https://us1.platform.bird.com/v1/esim/sims/{esim_id}/packages" \
-H "Authorization: Bearer $TOKEN"{
"data": [
{
"id": "epk_01krdgeqcxet5s7t44vh8rt9mg",
"order_id": "eor_01krdgeqcxet5s7t44vh8rt9mg",
"offer_id": "eof_01krdgeqcxet5s7t44vh8rt9mg",
"zone_id": "ezn_01krdgeqcxet5s7t44vh8rt9mg",
"zone_name": "Europe",
"countries": [
"US"
],
"status": "provisioning",
"speed": "full",
"price": {
"amount": "0.00995",
"currency_code": "USD"
}
}
]
}
Returns the eSIM's data packages with per-zone balances, validity, and status, newest first and in full: an eSIM holds at most package_limit concurrent packages. Balances update as mobile networks report usage; balance.as_of tells you how fresh they are.
参数
esim_idstringeSIM ID.
响应载荷
dataPackages, newest first.
显示子属性
data.iddata.order_idThe order that purchased this package.
data.offer_idOffer this package was purchased from.
data.zone_idCoverage zone the package draws on. The name and countries below are captured at purchase time; the zone resource carries the live footprint.
data.zone_nameCoverage zone name, from the offer.
data.countriesCountries the package's zone covers, captured at purchase time so the package is meaningful without fetching the offer.
data.statusdata.speedSpeed class, from the offer.
data.balancedata.activated_atWhen the package started consuming data (first use in its zone). Null until then.
data.expires_atWhen the package's validity ends and unused balance expires. Already capped by the eSIM's service period, so this is always the effective expiry. Null until the package activates.
data.priceWhat your workspace was billed for this package.
显示子属性
data.price.amountDecimal amount as a string, in major currency units.
data.price.currency_codeISO 4217 currency code.
data.created_at