SIM card diagnostics#
Simple SIM card diagnostics regarding network connection, GSM signal and device IMEI information are available for retrieval in the API as well. The diagnostics information are updated regularly as we receive information regarding a SIM card from the network. The history for the diagnostics of a SIM card is not available, only the latest information that we received is available in the API.
The information can be retrieved by following the URL:
GET /simcards/{icc}/diagnostics
Info
Only SIM cards that have been activated can be requested for diagnostics information.
Response structure and types
Field | Type | Description |
---|---|---|
icc | String | The unique identifier for the SIM card generating the usage. |
countryCode | String | Alpha-2 code for the current country in which the SIM card generated usage. |
countryCodeUpdatedDate | ISO 8601 DateTime | Last timestamp for when a change to the current country was observed. |
radioAccessTechnology | Radio Access Technology | Information about the latest radio technology we have observed the SIM card to use. |
radioAccessTechnologyUpdatedDate | ISO 8601 DateTime | Last timestamp for when we observed a change in the used radio technology. |
qci | QCI | Information about the latest quality control identifier observed for the SIM card on the network. |
qciUpdatedDate | ISO 8601 DateTime | Last timestamp for when we observed a change in the quality control indicator for the SIM card. |
ipAddress | String | IP address that was observed the SIM card on the network, this is only relevant for data traffic and package switching traffic. |
ipAddressUpdatedDate | ISO 8601 DateTime | Last timestamp for when we observed a change to the SIM cards ip address. |
imei | String | The latest IMEI number we observed for any usage generated by the SIM card. |
imeiUpdatedDate | ISO 8601 DateTime | Last timestamp for when we observed a change to the IMEI number for the SIM card on the network. |
operatorName | String | The name of the latest operator we observed the SIM card to be using. |
operatorNameUpdatedDate | ISO 8601 DateTime | Latest timestamp for when we observed a change of the operator that the SIM card is using. |
Example response
{
"icc": "89454284200010502223",
"countryCode": "DK",
"countryCodeUpdatedDate": "2018-12-20T12:04:54",
"radioAccessTechnology": "UTRAN",
"radioAccessTechnologyUpdatedDate": "2018-12-20T12:24:49",
"qci": "QCI_9",
"qciUpdatedDate": "2018-12-20T12:24:49",
"ipAddress": "212.88.72.198",
"ipAddressUpdatedDate": "2019-03-15T12:56:31",
"imei": "3533090701812526",
"imeiUpdatedDate": "2018-12-21T12:24:49",
"operatorName": "Telenor A/S",
"operatorNameUpdatedDate": "2019-02-21 11:07:45"
}
Info
Any of the properties except for the icc
may also be null
when the diagnostic information is returned.
If a value is null
it simply means we have received no information about that property from the SIM card.