Query Cell Information

purpose returns the serving cell information for a specified sim the target sim is specified using the \<iccid> element if the device is currently registered on a network, the current serving cell details will be returned if the device is not currently registered, the last recorded cell data from the previous network registration will be returned cell data is typically captured when a device registers on a network sends an sms initiates a voice call starts a data session applicability this query is only valid for supported sim types currently supported manx telecom multinet voda multinet m2m multinet manx kpn multinet kpn c multinet kpn o (not all apns are supported ) tele2 requests submitted for unsupported sim types will return invalid iccid use with location services this query can be used in conjunction with the lbs service to derive an approximate device location based on the serving cell response elements the response includes the following fields element description \<mcc> mobile country code (integer, 0–999) \<mnc> mobile network code (integer, 0–999) \<lac> location area code (hexadecimal) \<cellid> cell identifier (hexadecimal) \<age> time in seconds since the cell data was captured the \<age> value indicates how recent the recorded cell information is special failure condition in addition to the standard failure response, this query may return \<api outcome>cell data unavailable\</api outcome> this occurs when no cell data has been recorded for the device for tele2 and kpn sims, there has been no usage for more than 30 days endpoint post https //api m2miportal com content type application/xml accept application/xml request (xml) \<query cell info version="1" api id="123456"> \<authentication> \<username>username\</username> \<password>password\</password> \</authentication> \<iccid>1234567890123456789\</iccid> \</query cell info> response (success) \<query cell info response api id="123456"> \<api outcome>success\</api outcome> \<mcc>234\</mcc> \<mnc>15\</mnc> \<lac>0099\</lac> \<cellid>4d76\</cellid> \<age>1060\</age> \</query cell info response> response (failure) if a request cannot be processed, the response will include api outcome indicating failure an error description explaining the reason failure responses may occur due to invalid authentication credentials invalid or unknown identifiers (for example iccid or msisdn) invalid or missing parameters values not permitted for the specified sim type or account configuration insufficient permissions integrating systems should validate input data before submission and implement appropriate error handling and logging