---
title: "Configure eSIM (download profile and/or enable subscription)"
method: POST
path: "/devices/{deviceId}/esim"
tags: ["Tools"]
---

# Configure eSIM (download profile and/or enable subscription)

`POST /devices/{deviceId}/esim`

## Path parameters

- `deviceId` string, required

## Headers

- `X-Device-Display-ID` integer

## Request body

- ConfigureESimBody
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `confirmationCode` string — Optional carrier-issued confirmation code (the 4th LPA segment). Required only for plans whose SM-DP+ challenges the device for one. Requires matchingId — the LPA spec only interprets segment 4 when segment 3 is present.
  - `enable` boolean, required
  - `matchingId` string
  - `smDpAddr` string, required

## Response `200`

OK

- ESimSubscription
  - `$schema` string, uri — A URL to the JSON Schema for this object.
  - `carrier` string, required
  - `displayName` string, required
  - `iccid` string, required
  - `isEmbedded` boolean, required
  - `slot` integer, required
  - `subId` integer, required
  - `type` string, required

## Other responses

- `default` — Error

---

[API](https://skmtc.net/droidrun/apis/droidrun-cloud.md) · [All operations](https://skmtc.net/droidrun/apis/droidrun-cloud/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/droidrun/droidrun-cloud/revisions/7f577998739b/schema)