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.