Top Up an eSIM

Overview

An existing eSIM can have multiple packages assigned simultaneously. This allows customers to purchase additional data without replacing or reinstalling the eSIM profile.

1. Find Compatible Packages

Retrieve available packages for the existing eSIM.

Request

POST /api/v1/esims/find-packages

curl --location "https://esim-api.it-decision.com/api/v1/esims/find-packages" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <TOKEN>" \
--data '{
  "esims": [
    "<ESIM_ID>"
  ]
}'

Result

The response returns a list of compatible packages available for the selected eSIM. Select the desired packageId.

2. Assign the New Package

Assign the selected package to the existing eSIM.

Request

POST /api/v1/esims/add-esims

curl --location "https://esim-api.it-decision.com/api/v1/esims/add-esims" \
--header "Content-Type: application/json" \
--header "Authorization: Bearer <TOKEN>" \
--data '{
  "esims": [
    "<ESIM_ID>"
  ],
  "packages": [
    "<PACKAGE_ID>"
  ],
  "client": "<CLIENT_ID>"
}'

Response

204 No Content

Result

The new package is associated with the existing eSIM.

No new eSIM profile or QR code is required. The customer continues using the same installed eSIM, and additional connectivity becomes available according to the assigned package rules.