Using Our APIs
Information Requests
Query Status
6 min
purpose returns the current sim status for the sim specified in the \<iccid> element the response includes a \<status> element indicating the operational state of the sim possible status values sim status description active the sim is activated this is a necessary but not sufficient condition for full operation typically, the sim must also be in a live group and (for manx telecom sims) have sufficient nominal credit available deactivated the sim is deactivated and cannot generate data, sms or voice traffic closed the sim is permanently closed and cannot generate data, sms or voice traffic important if the api response returns \<status>closed\</status> your application should stop making further api calls for that sim closed sims are permanently inactive endpoint post https //api m2miportal com content type application/xml accept application/xml request (xml) \<query status version="1" api id="123456"> \<authentication> \<username>username\</username> \<password>password\</password> \</authentication> \<iccid>1234567890123456789\</iccid> \</query status> response (success) \<query status response api id="123456"> \<api outcome>success\</api outcome> \<status>active\</status> \</query status 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