# ES4 interface description

{% hint style="warning" %}
The KPN RSP Gateway has not implemented every interface of the GSMA SGP.02 v3.2 / v4.0 specification. Upon request more interfaces can be implemented. Please contact [support](https://docs.kpnthings.com/kpn-things/rsp/help/support) for more information.
{% endhint %}

#### Legend

| Icon | Interface type | Source   | Target   |
| ---- | -------------- | -------- | -------- |
| 💠   | Function call  | Customer | KPN      |
| 🔔   | Notification   | KPN      | Customer |

## General

### ES4 - communication with SM-SR

{% hint style="info" %}
The ES4 interface is only available if you have KPN RSP SIM cards.
{% endhint %}

The following URI is the endpoint to perform all ES4 function calls.

```http
https://rsp.kpnthings.com/esim-messaging/3/ES4/ES4SmSrService
```

### Attributes

* replyTo - is considered required. Without replyTo attribute, no callback will be performed for the function call.

## The interfaces

### Auditing eUICC Information 💠

> Section 5.5.4 of the [SGP.02 v3.2 specification](https://www.gsma.com/newsroom/resources/sgp-02-v3-2-remote-provisioning-architecture-for-embedded-uicc-technical-specification/).

Provides you with information about the profiles on one of your KPN RSP SIM cards.

*We verify your ownership of the EID and the ICCID.*

### Profile Enabling 💠

> Section 5.5.5 of the [SGP.02 v3.2 specification](https://www.gsma.com/newsroom/resources/sgp-02-v3-2-remote-provisioning-architecture-for-embedded-uicc-technical-specification/).

Allows you to enable a profile (identifiable by ICCID) that is already downloaded to your KPN RSP SIM card (identifiable by EID).

{% hint style="warning" %}
You will **not** receive a Profile Enabled notification for the profile you enable through this API call.
{% endhint %}

*We verify your ownership of the EID and the ICCID.*

#### Debugging

* You can only enable a profile that is already on the SIM.
* You can only send a command to a SIM card that is yours.

### Set Fall-Back Attribute 💠

> Section 5.5.21 of the [SGP.02 v4.0 specification](https://www.gsma.com/newsroom/wp-content/uploads/SGP.02-v4.0.pdf).

Allows you to set a profile as fallback for a specific RSP SIM card.

*We verify your ownership of the EID and the ICCID.*

{% hint style="warning" %}
It is **not** possible to specify a Validity Period per request. Currently set to a fixed period of 720 seconds.
{% endhint %}

### Notify a Profile is Disabled 🔔

> Section 5.5.10 of the [SGP.02 v3.2 specification](https://www.gsma.com/newsroom/resources/sgp-02-v3-2-remote-provisioning-architecture-for-embedded-uicc-technical-specification/).

With this notification we signal you when a profile on one of your RSP SIM cards has been disabled.

### Notify a Profile Enabling 🔔

> Section 5.5.11 of the [SGP.02 v3.2 specification](https://www.gsma.com/newsroom/resources/sgp-02-v3-2-remote-provisioning-architecture-for-embedded-uicc-technical-specification/).

With this notification we signal you when a profile on one of your RSP SIM cards has been enabled.