# 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](/kpn-things/rsp/help/support.md) 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.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.kpnthings.com/kpn-things/rsp/transparent-api/es4.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.