Skip to content

Revokes latest assignment of given bundle to an eSIM

DELETE
/esims/{iccid}/bundles/{name}

Revokes latest assignment of a given Bundle type.

If a bundle assignment has not been started and no data has been consumed, the bundle assignent can either be returned to the inventory or credited back to the organisations balance.

If the bundle assignment has started, or was purchased outside of their permitted refund period, typically 60 days, it cannot be returned to the inventory or taken as a credit.

Note: Bundle names are case sensitive and should be typed like the following “esim_1GB_7D_IM_U”.

Authorizations

Parameters

Path Parameters

iccid
required
string

The ICCID of the eSIM

name
required
string

Name of Bundle

Format as defined in List Catalogue API call. Example: esim_10GB_30D_IM_U

Query Parameters

refundToBalance
boolean

If Applicable, refund the value of this bundle to organisation balance

offerId
string

If Applicable, the offerId of the bundle to revoke. needed for refunding to balance

type
string
Allowed values: validate transaction

Type validate will provide options for the revoke and the behaviours, if any. type transaction will execute the revoke. Defaults to transaction

Responses

200

Success message

object
status

Status of Bundle

string

400

Bad Request - returned when request format is not accepted

object
message

Status of api functions which do not return data

string

403

Unauthorised - returned when the api token is invalid; the user does not have any available Bundles left or the eSIM is not accessible by the user

object
message

Status of api functions which do not return data

string

500

Server Error

object
message

Status of api functions which do not return data

string