Buvei
API ReferenceeSIM

Get eSIM Order

Look up a purchase order's state — the polling counterpart to the terminal-state webhooks.

GET/open-api/v1/esim/orders/{orderNo}

Returns one of your eSIM purchase orders. Use it to learn the final state of a purchase that returned PAID (or to fetch qrCode after an ESIM_ISSUED webhook — the webhook payload intentionally omits the QR).

Returns 404 if the order does not exist or belongs to another project.

Path parameters

orderNostringpathrequired

Order id (eord_...) from the purchase response.

Response

orderNostring
statusstring
PAID · ISSUING · ISSUED · FAILED (refund pending) · REFUNDED.
planNostring
priceUsdinteger
Charged price, USD cents.
esimNostring
eSIM id (esim_...). null until issued.
iccidstring
null until issued.
qrCodestring
LPA install string. null until issued.
createdAtinteger
Epoch milliseconds.
Response
{
  "code": 0,
  "message": "SUCCESS",
  "data": {
    "orderNo": "eord_9fec42a158b64f8ba4",
    "status": "ISSUED",
    "planNo": "epln_b312537653c3a51f00",
    "priceUsd": 92,
    "esimNo": "esim_6ba300976dbb48b8a1",
    "iccid": "8948010010043989416",
    "qrCode": "LPA:1$smdp.io$K2-XXXXXX-XXXXXXX",
    "createdAt": 1783863739000
  }
}
{
  "code": 404,
  "message": "Order not found"
}