Query MSISDN
5 min
Purpose
Returns the MSISDN (telephone number) assigned to a specified SIM.
The target SIM is specified using the <iccid> element.
The response includes the <msisdn> element, provided in E.164 format.
Response Element
Element | Description |
|---|---|
<msisdn> | The MSISDN telephone number in E.164 format (e.g. 441234567890) |
Endpoint
POST https://api.m2miportal.com
Content-Type: application/xml
Accept: application/xml
Request (XML)
<query-msisdn version="1" api-id="123456">
<authentication>
<username>username</username>
<password>password</password>
</authentication>
<iccid>1234567890123456789</iccid>
</query-msisdn>Response (Success)
<query-msisdn-response api-id="123456">
<api-outcome>Success</api-outcome>
<msisdn>441234567890</msisdn>
</query-msisdn-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.