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:
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.