API v2.4 / eSIMs / Revoke specific Bundle

Server

DELETE

/esims/{iccid}/bundles/{name}/assignments/{assignmentId}

eSIM Go API

IMPORTANT: If there are no bundles left on the eSIM AFTER the revoke, AND if the eSIM is not installed, the eSIM will undergo the eSIM Go returns process. The start of the returns process will immediately REMOVE the eSIM from your account - you will no longer be able to access it. After a minimum of 4 days: if during the returns process, the eSIM is now installed (e.g. by your end user), the eSIM will be returned to your account. If you DO NOT want the eSIM to be given back to eSIM Go, ensure the eSIM either:- - Is installed - Has more than 1 bundle on it at the time of revoking --- Revokes a single assignment of a given Bundle type. e.g. Can remove 1 month from a 1-year Bundle. Note: Bundle names are case sensitive and should be typed like the following “esim_1GB_7D_IM_U”.

Authorizations

apikeyAuth

Parameters

Path Parameters

iccid

required

string

(Required) The ICCID of the eSIM

Example

8944123456789012000

name

required

string

(Required) Name of Bundle Format as defined in [List Catalogue](/api/#get-/catalogue) API call. Example: `esim_10GB_30D_IM_U`

Example

esim_10GB_30D_IM_U

assignmentId

required

string

(Required) ID of individual Bundle Assignment to revoke from an eSIM

Example

123231231

Query Parameters

type

string

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

Example

validate

Responses

200

object

status

Status message of api request

string

Example

{
  "status": "Successfully Revoked Bundle, bundle has been refunded to inventory"
}