Sign inGet Started
Comenzar
Guías
Referencia de API
SDKs
CLI
Base de conocimientos
Registro de cambios

List an eSIM's data packages

GET
/v1/esim/sims/{esim_id}/packages
bird esim packages list <esim-id>
Respuesta200
{
  "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.

Parámetros

esim_idstring

eSIM ID.

Carga de respuesta

data
array of object
obligatorio

Packages, newest first.

Mostrar atributos secundarios
data.id
string
obligatorio
data.order_id
string
obligatorio

The order that purchased this package.

data.offer_id
string
obligatorio

Offer this package was purchased from.

data.zone_id
string
obligatorio

Coverage zone the package draws on. The name and countries below are captured at purchase time; the zone resource carries the live footprint.

data.zone_name
string
obligatorio

Coverage zone name, from the offer.

data.countries
array of string
obligatorio

Countries the package's zone covers, captured at purchase time so the package is meaningful without fetching the offer.

data.status
string
obligatorio
data.speed
string
obligatorio

Speed class, from the offer.

data.balance
object
obligatorio
Mostrar atributos secundarios
data.balance.total_bytes
integer
obligatorio

Total data in bytes, as purchased. Known from the order, so never null.

data.balance.used_bytes
nullable integer
obligatorio

Data used in bytes, or null while no network has reported on this package.

data.balance.remaining_bytes
nullable integer
obligatorio

Data remaining in bytes, or null while no network has reported on this package.

data.balance.used_percent
nullable number
obligatorio

Share of the total data already used, as a percentage. Null while no network has reported on this package.

data.balance.as_of
string
obligatorio

When the balance was last established. Before consumption is reported, this is the package delivery time. Check whether the consumption fields are null before treating this timestamp as a usage update.

data.balance.observed_at
nullable string
obligatorio

Measurement time supplied by the mobile network. Null when no measurement or measurement time is available. Use as_of for the balance update time.

data.activated_at
nullable string

When the package started consuming data (first use in its zone). Null until then.

data.expires_at
nullable string

When 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.price
object
obligatorio

What your workspace was billed for this package.

Mostrar atributos secundarios
data.created_at
string
obligatorio

Recursos relacionados

Continúa con la documentación, guías y ejemplos de este tema.

Obtener un resumen de implementación