When a device connects to a mobile network, Soracom creates a record of the event (known as a "Session Event") containing various information about the connection such as the date and time of the connection, the event type (Created when connecting, Deleted when disconnecting, and Modified when the connection details change), the name of the network operator, the country and cell ID where the device is located, and the IMEI of the device (if reported by the network operator). This information can be helpful for checking device behavior and troubleshooting some connection issues.

Current Session Event behavior

Currently, the Session Event history can be viewed from the User Console or retrieved using the following APIs, each with a corresponding retention period:

• Sim:listSimSessionEvents (used by the New SIM Management view in the User Console) - 14-day retention period
• Subscriber:listSessionEvents (used by the Old SIM Management view in the User Console) - no retention period (all session event history can be retrieved)

What's changing

With this update, the retention period for these APIs will be modified as follows:

• The Sim:listSimSessionEvents retention period will be increased to 32 days (1 month + 1 day)
• The Subscriber:listSessionEvents retention period will be reduced to 32 days

Once a Session Event exceeds the retention period, it is archived and cannot be viewed on the User Console. Similarly, when retrieving Session Event history from the API, you will no longer be able to access older events that have exceeded the retention period.

Effective date

This update will take effect on November 1, 2021.

For more information about SIM or Subscriber session details, please refer to the Subscriber Status documentation.