The SIM Data Sessions list resource returns Data Session information for a SIM over no more than a 30 day period, presented as an aggregated list.
A Data Session represents an individual data connectivity session between the SIM-connected device and a service that interfaces between the cellular network and the Internet. This will either be a PDP Context via a GGSN or a PDN Connection via a Packet Gateway.
Very simply, you can think of a Data Session as a representation of your device's Internet connection, whenever such a connection exists.
Data Sessions are useful for troubleshooting device issues and understanding the network setup and teardown behavior of a device in the wild.
This resource and its subresources always return a list of SIM Data Sessions. Each Data Session is represented by the following properties:
|sid||String||The unique id of the Data Session resource that this Data Record is for.|
|sim_sid||String||The unique id of the SIM resource that this Data Session is for.|
|account_sid||String||The unique id of the Account that the SIM belongs to.|
|start||DateTime||The date that this Data Session started, given as GMT in ISO 8601 format.|
|end||DateTime||The date that this record ended, given as GMT in ISO 8601 format.|
|last_updated||DateTime||The date that this resource was last updated, given as GMT in ISO 8601 format.|
|operator_mcc||String||The 'mobile country code' is the unique id of the home country where the Data Session took place. See: MCC/MNC lookup.|
|operator_country||String||The three letter country code representing where the device's Data Session took place. This is derived from a lookup of the
|operator_mnc||String||The 'mobile network code' is the unique id specific to the mobile operator network where the Data Session took place.|
|operator_name||String||The friendly name of the mobile operator network that the SIM-connected device is attached to. This is derived from a lookup of the
|cell_id||String||The unique id of the cellular tower that the device was attached to at the moment when the Data Session was last updated.|
|cell_location_estimate||Object||An object representing the estimated location where the device's Data Session took place. See Cell Location Estimate Object below. This is derived from the
|radio_link||String||The generation of wireless technology that the device was attached to the cellular tower using.|
|packets_downloaded||Integer||The number of packets downloaded by the device between the
|packets_uploaded||Integer||The number of packets uploaded by the device between the
|imei||String||The 'international mobile equipment identity' is the unique id of the device using the SIM to connect. 15-digit string: 14 digits for the device identifier plus a check digit calculated using the Luhn formula.|
The Cell location estimate object reports the approximate location of the cellular tower that the device was connected to when the Data Session was last updated. This is based on a lookup of public cellular tower data, and is not necessarily an accurate description of the cellular tower. It is not intended to describe the location of the SIM-connected device itself.
|lat||Integer||Latitude. The spherical coordinate value of the estimated cellular tower location parallel to the Equator.||0|
|lon||Integer||Longitude. The spherical coordinate value of the estimated cellular tower location from the geographical North Pole to the geographical South Pole.||0|
Request a list of SIM Data Sessions for the last 30 days using the SIM Sid, represented as JSON.