ES4 interface description

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 for more information.

Legend

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

General

ES4 - communication with SM-SR

The ES4 interface is only available if you have KPN RSP SIM cards.

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

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.

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.

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

You will not receive a Profile Enabled notification for the profile you enable through this API call.

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.

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

We verify your ownership of the EID and the ICCID.

It is not possible to specify a Validity Period per request. Currently set to a fixed period of 720 seconds.

Notify a Profile is Disabled 🔔

Section 5.5.10 of the SGP.02 v3.2 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.

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