Apply a Bundle to an eSIM with eSIM auto-assign

POST

/esims/apply

• eSIMGo API

This endpoint enables you to receive a new eSIM with the specified Bundle pre-applied.

Usage:

• Either provide Bundle or Bundles.
• If an ICCID is provided as well as only a Bundle, the Bundle will be applied to the eSIM for that ICCID.
• If no ICCID is provided, a new eSIM will be assigned to you, and the Bundle applied.
• If no ICCID is provided, as well as only providing a Bundle, Repeat can be provided to assign Repeat eSIMs to you with the Bundle applied.
• If Bundles is provided, seperate new eSIMs will be provided to you for each bundle.
• The ICCID is always returned in the response.
• An ICCID cannot be provided in conjunction with the Repeat field.
• Bundle names are case sensitive and should be typed like the following “esim_1GB_7D_IM_U”.

Notes:

• In order to use this you must first have already purchased Bundles and have them available in your inventory on your account.
• In some cases, it may take up to 5 minutes for your eSIM bundles to be delivered

Authorizations

• apiKeyAuth
• apiKeyQueryAuth

Request Body ^required

Details of Bundle to apply to eSIM

One of:

object

object

iccid

ICCID of target eSIM to apply Bundle to. If not provided, a new eSIM will be assigned to you.

string

bundle

Name of Bundle to apply

string

bundles

List of names of Bundles to apply

Array<string>

startTime

When the Bundle should start (if left empty, Bundle will start immediately)

Note: This is only applicable to a Bundle with autostart: false

Format as defined in RFC 3339, section 5.6. Timezone is UTC (ends with ‘Z’). Example: 2006-01-02T15:04:05Z

string

repeat

How many eSIMs will be assigned with this bundle applied (if left empty Bundle will assign to one eSIM)

integer

object

object

bundles

required

Array<object>

object

name

required

Name of Bundle to apply

string

startTime

When the Bundle should start (if left empty, Bundle will start immediately)

Note: This is only applicable to a Bundle with autostart: false

Format as defined in RFC 3339, section 5.6. Timezone is UTC (ends with ‘Z’). Example: 2006-01-02T15:04:05Z

string

repeat

How many eSIMs will be assigned with this bundle applied (if left empty Bundle will assign to one eSIM)

integer

Examples

{
  "name": "bundle_name"
}

{
  "bundles": [
    {
      "name": "bundle_one"
    },
    {
      "name": "bundle_two"
    }
  ]
}

Responses

200

Success message

object

esims

Array<object>

object

iccid

Newly assinged eSIM ICCID

string

status

Status of Bundle

string

applyReference

Apply Reference

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 ICCID 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

503

Processing - Please come back later or use the Retry-After (seconds) header

object

message

Status of api functions which do not return data

string