Important: This MNP is only available for lookup information on Australia MSISDN.
The MNP-API enables a lookup service for Australian MSISDN. Each transaction will incur a cost of $0.02 AUD including GST.
The Basic method enables users to validate whether a particular Australia MSISDN is valid. The Client issues either a HTTP GET or POST request to the SMSGlobal HTTP interface supplying a list of required parameters. SMSGlobal issues back a HTTP Response which indicates the validity of the MSISDN.
The same HTTP GET or POST request is submitted to SMSGlobal, however the more details results are pushed back to you.
Delivery options include email and HTTP Post Back.
The MNP lookup service is capable of providing the following information for an MSISDN.
URL: https://api.smsglobal.com/mnp/msisdn.php
Find below a list of accepted parameters.
Parameter | Description | Options | Presence |
---|---|---|---|
username | Your SMSGlobal username | Mandatory | |
password | Your SMSGlobal password | Mandatory | |
msisdn | MSISDN (mobile no). Must use full country code. E.g. 61432162111 | Mandatory |
The response from the request will return either the status of OK together with a MNP Lookup ID, or a status of ERR together with an error code and message.
Format: {MSISDN};{Internal ID};{MCC-MNC};{Carrier Name / Porting}
Example: Requesting MNP Lookup
Below is an example request for MSISDN lookup.
https://api.smsglobal.com/mnp/msisdn.php?username=testuser&password=secret&msisdn=61447100250
61447100250;551;505-01;Telstra;
Format: {error};{error code};{error message}
Error;5;Incorrect username / password;
Find below a list of possible errors.
Error | |
---|---|
1 | Username not supplied |
2 | Password not supplied |
3 | MSISDN not supplied |
4 | Not enough credits |
5 | Incorrect username / Password |