Soracom Air for Cellular
Local Info Report
Local Info Report is currently available as a beta release. Functionality may be subject to change.
Local Info Report is a feature that allows you to retrieve device information directly from a device by using a Java applet that is embedded into plan01s and plan01s - LDV Air SIMs. Unlike the basic network-provided SIM details that are available on the User Console or through the Soracom API or Soracom CLI, the Local Info Report is able to detailed information about the SIM and device status, such as: ICCID, IMSI, MSISDN, IMEI, Location, and Battery level (if supported by your device).
In order to use Local Info Report, your Air SIM must be:
- A plan01s or plan01s - LDV SIM
- Installed in a device that supports BIP (Bearer Independent Protocol)
- Located in a region where cellular coverage is available
Requesting a Report
Requesting a Local Info Report will incur an MT SMS fee. Refer to the Pricing & Fee Schedule for more information.
Login to the User Console. From the Menu, open the SIM Management screen.
From the list of subscribers, click the for the SIM you want to view, then click the Details button.https://console.soracom.io
From the SIM Details dialog, click the SIM Local Info tab.
Click the Request Report button. A request will be sent to the SIM to execute the Local Info Report applet.
The report may take up to a minute to generate, and will automatically appear when the device has sent the report to the User Console.
You can also use the Soracom API, Soracom CLI, and Metadata Service to trigger a Local Info Report.
To access the Soracom API, first use the auth API to obtain an API Key and Token. Refer to the API Reference Guide for instructions on how to use the API Key and Token in API requests.
Then, use the reportLocalInfo API to request a Local Info Report from an Air SIM:
curl -X POST \ > -H 'X-Soracom-API-Key: <MY-API-KEY>' \ > -H 'X-Soracom-Token: <MY-TOKEN>' \ > https://g.api.soracom.io/v1/subscribers/<IMSI>/report_local_info
If the Local Info Report request is successful, you can then retrieve the report using the getSubscriber API:
curl -X GET \ > -H 'X-Soracom-API-Key: <MY-API-KEY>' \ > -H 'X-Soracom-Token: <MY-TOKEN>' \ > https://g.api.soracom.io/v1/subscribers/<IMSI>
The report will be included in the response as a
To use the Soracom CLI, you must first configure it to authenticate with your account information, authorization key, or SAM user credentials.
Then, run the following command to request a Local Info Report from an Air SIM:
soracom subscribers report-local-info --imsi <IMSI> --coverage-type g
If the Local Info Report request is successful, you can then retrieve the report using this command:
soracom subscribers get --imsi <IMSI> --coverage-type g