POSTeSIM Management

Create eSIM

Use this endpoint to provision a new eSIM. The request requires the product_id of the desired eSIM plan and the ISO3 country code in the request body. A successful response returns the eSIM's ICCID, activation code, and associated data plan details.

Endpoint

POSThttps://api.sotel.com/api/esim/create

Authentication

Requires a bearer token obtained from the /authenticate endpoint. Include it in the Authorization header.

Authorization: Bearer {token}

Request Body

Name	Type	Required	Description
`productId`	string	Required	The unique identifier of the data plan to assign to the eSIM. Obtain this from the Get Data Plans endpoint.
`iso3`	string	Required	ISO alpha-3 country code for the eSIM (e.g. "USA", "GBR", "NGA").

Request Example

{
  "productId": "21170179",
  "iso3": "USA"
}

Response

eSIM created and provisioned successfully.

Response

{
  "sim": {
    "id": 8,
    "iccid": "8910300000045513278",
    "productId": "21170170",
    "imsi": "310840118755316",
    "state": "INACTIVE",
    "lastOperationDate": "2025-12-23 19:58:29",
    "activationCode": "TN20250825145316F4221A9A",
    "smdp": "consumer.e-sim.global",
    "purchaseDate": "2026-06-04T15:48:50.198+01:00"
  },
  "dataPlan": {
    "productId": "21170170",
    "name": "Netherlands 1GB 5 days",
    "dataUsageAllowance": 1,
    "timeAllowance": 5,
    "country": "Netherlands",
    "iso3": "NLD",
    "region": "Europe"
  }
}

Code Examples

curl -X POST 'https://api.sotel.com/api/esim/create' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -d '{
    "productId": "21170179",
    "iso3": "USA"
  }'

Try It

Fill in the parameters to generate a cURL command

Base URL

Bearer Token

Request Body

productId *

iso3 *

Generated cURL

curl -X POST 'https://api.sotel.com/api/esim/create' \
  -H 'Authorization: Bearer {token}' \
  -H 'Content-Type: application/json' \
  -d '{
  "productId": "{productId}",
  "iso3": "{iso3}"
}'

Get Data Plans List eSIMs