Sign inGet Started
Aan de slag
Gidsen
API Reference
SDK's
CLI
Kennisbank
Changelog

Remove a data package

DELETE
/v1/esim/sims/{esim_id}/packages/{package_id}
bird esim packages delete <esim-id> <package-id> --yes
Reactie202
{
  "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"
  }
}

Removes a data package and frees capacity under the eSIM's package_limit. Remaining data is forfeited without a refund. If usable balance remains, the request returns 409 unless acknowledge_balance_forfeit=true.

A 202 response returns the package in removing. Use Get a data package to confirm removed. If the network rejects removal, the package returns to its previous status.

Parameters

esim_idstring

eSIM ID.

package_idstring

Data package ID.

Queryparameters

acknowledge_balance_forfeitboolean

Confirms you accept that the package's remaining balance is forfeited. Omitted or false while balance remains, the request fails with a conflict error.

Response Payload

id
string
verplicht
order_id
string
verplicht

The order that purchased this package.

offer_id
string
verplicht

Offer this package was purchased from.

zone_id
string
verplicht

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

zone_name
string
verplicht

Coverage zone name, from the offer.

countries
array of string
verplicht

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

status
string
verplicht
speed
string
verplicht

Speed class, from the offer.

balance
object
verplicht
Onderliggende attributen tonen
balance.total_bytes
integer
verplicht

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

balance.used_bytes
nullable integer
verplicht

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

balance.remaining_bytes
nullable integer
verplicht

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

balance.used_percent
nullable number
verplicht

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

balance.as_of
string
verplicht

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.

balance.observed_at
nullable string
verplicht

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

activated_at
nullable string

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

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.

price
object
verplicht

What your workspace was billed for this package.

Onderliggende attributen tonen
created_at
string
verplicht

Gerelateerde bronnen

Ga verder met de documentatie, handleidingen en voorbeelden voor dit onderwerp.

Ontvang een implementatieoverzicht