SIM ID to be added to Data Usage History CSVs
We would like to inform customers that the format of service usage history CSVs is scheduled to be updated to include SIM IDs.
Service usage history CSVs provide detailed usage information, such as how much data each SIM has consumed, or how many Soracom Beam or Soracom Harvest requests each SIM has sent during a specified timeframe.
Until now, SIMs could be identified in these service usage history CSVs using their 15-digit IMSI number. However, with the use of Subscription Containers, a single physical SIM may contain more than one IMSI, and the service usage history data will be attributed according to the IMSI that was active at the time of usage.
With this update, each line of the service usage history CSVs will also include the SIM's 19- or 32-digit SIM ID. As the SIM ID uniquely identifies each physical SIM regardless of whether Subscription Containers have been added, you will be able to easily track the total service usage for a particular SIM no matter which of its IMSIs were active.
For download instructions and additional information on service usage history CSVs, please refer to the following documentation:
This update is scheduled to take effect on August 24, 2023.
Using column names from the header row
As we continue to improve usage history features, the CSV format (such as the order of its columns) may occasionally change over time. Therefore, when programmatically processing these CSVs, we recommend referencing each line's values based on the column name found in the first line (the header row) of each CSV file, rather than column number. This will allow your scripts or programs to continue referencing the correct data, even if the column order changes.
If you need assistance with referencing the data in a CSV file using column names rather than column numbers, please don't hesitate to contact our support team.