Notifications / Notifications / Location Update

Server

POST

LocationUpdate

This notification’s alertType is CountryChange.

Triggering Location Update Notifications

A location update notification is sent each time an eSIM registers in a new country that it hasn’t visited in the last 24 hours. It’s important to note that actual usage of the eSIM bundle is not necessary for these notifications. The only requirement is that the eSIM successfully registers on a network in a new country.

Frequency of Notifications

After the initial notification, a subsequent location update is sent every 24 hours. If the eSIM remains in the same country after 24 hours, a new notification will confirm the end-user’s continued presence in that country.

Use Case for Location Change Tracking

Tracking country changes can be valuable for monitoring your end-users’ travel patterns. This information offers a strategic opportunity for upselling, especially if the end-user travels to a country not included in their current eSIM bundle(s).

Conditions and Exceptions

Please note that if an end-user returns to a country they visited within the past 24 hours, a location update notification will not be generated. While all country change notifications are sent, you may need to filter them according to your specific requirements.

Request Body^required

Select media type

object

alertType

Type of alert

string

iccid

ICCID of the eSIM

string

8944538532008160222

country

object

code

Country code

string

NO

name

Country name

string

Norway

Select example

{
  "alertType": "CountryChange",
  "iccid": 8944538532008160000,
  "country": {
    "code": "NO",
    "name": "Norway"
  }
}

No response body