Query IMEI

purpose returns device imei information associated with the sim specified in the \<iccid> element this request retrieves the most recently detected imei, when it was first recorded, and the previously recorded imei where available endpoint post https //api m2miportal com content type application/xml accept application/xml request (xml) \<query imei version="1" api id="123456"> \<authentication> \<username>username\</username> \<password>password\</password> \</authentication> \<iccid>1234567890123456789\</iccid> \</query imei> response (success) \<query imei response api id="123456"> \<api outcome>success\</api outcome> \<current imei>359827045164210\</current imei> \<last change>22/03/2020 13 55 30\</last change> \<previous imei>862057044700000\</previous imei> \</query imei response> response elements element description \<current imei> the current 15 digit imei where available \<last change> the date and time when the current imei was first detected format dd/mm/yyyy hh\ mm\ ss all times are utc \<previous imei> the previously recorded 15 digit imei where available if no information is available for an element, it will be returned empty for example, if a sim has only ever been used in one device, \<previous imei> will be empty behaviour notes imei detection is network dependent not all networks support imei reporting some networks only record the imei after certain events (for example, completion of a successful data session) \<last change> reflects when the imei was recorded by the network, not when the sim was physically inserted into the device some networks report imeis in a 16 digit format including a software version number the api converts this to the standard 15 digit format (14 digits plus luhn check digit) before returning it 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