Notifications / Types / Profile Status Change

Server

POST

ProfileStatusChange

Sent when the profileStatus of an eSIM changes, so you can track installs and removals without polling Get eSIM details.

The profileStatus values match those returned by Get eSIM details:

• Downloaded - The eSIM profile has been downloaded to a device but not yet installed.
• Installed - The eSIM profile is installed on a device.
• Released - The eSIM profile has been deleted from the device.

A notification is only sent when the status changes.

device describes the device the change happened on, and is omitted when no device information is available. Within it, only fields with a known value are returned: a Released notification usually carries only the eid, and make and model are only included when the device’s TAC is recognised.

Request Body ^required

object

alertType

required

string

Allowed values: ProfileStatusChange

iccid

required

Unique eSIM Identifier

string

8944538532008160222

profileStatus

required

The new status of the eSIM profile, as returned by Get eSIM details

string

Allowed values: Downloaded Installed Released

Installed

eventTime

required

When the status change happened on the device

string format: date-time

2026-11-02T14:05:18Z

device

The device the status change happened on. Omitted when no device information is available. Only fields with a known value are returned.

object

imei

The International Mobile Equipment Identity of the device. Omitted when not known.

string

350089571234565

eid

The eUICC Identifier of the device’s embedded SIM. Omitted when not known.

string

89049032021008881300304741158317

tac

The Type Allocation Code of the device (the first 8 digits of the IMEI), which identifies its make and model. Omitted when not known.

string

35008957

make

The device manufacturer. Omitted when the TAC is not known or not recognised.

string

APPLE

model

The device model. Omitted when the TAC is not known or not recognised.

string

IPHONE DUO

Examples

{
  "alertType": "ProfileStatusChange",
  "iccid": "8944538532008160222",
  "profileStatus": "Installed",
  "eventTime": "2026-11-02T14:05:18Z",
  "device": {
    "imei": "350089571234565",
    "eid": "89049032021008881300304741158317",
    "tac": "35008957",
    "make": "APPLE",
    "model": "IPHONE DUO"
  }
}

{
  "alertType": "ProfileStatusChange",
  "iccid": "8944538532008160222",
  "profileStatus": "Released",
  "eventTime": "2026-11-09T09:42:29Z",
  "device": {
    "eid": "89049032021008881300304741158317"
  }
}

Responses

None

No response body