For an optimised experience, please select your most relevant region.

Mobile Number Portability (MNP)

Stay personal by using your own mobile number

Overview

Important: This MNP is only available for lookup information on Australia MSIDSN.

The MNP-API enables a lookup service for Australian MSISDN. Each transaction will incur a cost of $0.02 AUD including GST.

There are 2 lookup methods available with the MNP-API.

  • Basic
  • Advanced

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 Advanced method provides much more detailed information which indicates carrier ownership, country of origin and location. It is also possible to determine whether the MSISDN has been ported to a different carrier.

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.


Benefits Scroll to Topexpand_less

The MNP lookup service is capable of providing the following information for an MSISDN.

  • Validate whether an Australia MSISDN is in active service
  • Advanced lookup option
  • Determine which carrier owns an MSISDN
  • Determine whether the MSISDN has been ported to another carrier
  • Delivery Receipt Notifications via Email/SMS
  • 24/7 support via our support system

Basic MSISDN Lookup Scroll to Topexpand_less

URL: https://www.smsglobal.com.au/mnp/msisdn.php
HTTP Request

Find below a list of accepted parameters.

ParameterDescriptionOptionsPresence
usernameYour SMSGlobal username
Mandatory
passwordYour SMSGlobal password
Mandatory
msisdnMSIDSN (mobile no). Must use full country code. E.g. 61432162111
Mandatory
HTTP Response

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.

Example Successful Lookup Message
Format: {MSISDN};{Internal ID};{MCC-MNC};{Carrier Name / Porting}

Example: Requesting MNP Lookup

Below is an example request for MSISDN lookup.

Request:
https://smsglobal.com.au/mnp/msisdn.php?username=testuser&password=secret&msisdn=61447100250
Output:
61447100250;551;505-01;Telstra;
Example Error Message:
Format: {error};{error code};{error message
Output:
Error;5;Incorrect username / password;
Errors:

Find below a list of possible errors.

Description Username not suppliedPassword not suppliedMSISDN not suppliedNot enough creditsIncorrect username / password

Error
12345

Advanced MSISDN Lookup Request Scroll to Topexpand_less

URL: https://www.smsglobal.com.au/mnp/hlr_network.php
HTTP Request

Find below a list of accepted parameters.

ParameterDescriptionOptionsPresence
usernameYour SMSGlobal username
Mandatory
passwordYour SMSGlobal password
Mandatory
msisdnMSIDSN (mobile no). Must use full countrycode. E.g. 61447100250
Mandatory
Example: Requesting MNP Lookup

Below is an example request for MSISDN lookup.

Username: testuser Password: secret MSISDN: 61447100250

Request:
https://www.smsglobal.com.au/mnp/hlr_network.php?username=testuser&password=secret&msisdn=61447100250
Output:

OK 6191

Example Error Message Format: {status} {error code} {error message}

Output:

Errors

ERR 750 Invalid MSISDN

Find below a list of possible errors.

ErrorDescription
88Not enough credits
99Unknown error
100Incorrect username/password
300Missing MSISDN
750Invalid MSISDN
Advanced MSISDN Lookup Result

If you would like more detailed lookup information you can activate your results to either be pushed to your email address or back to your server using HTTP Post Back method.


HTTP Post Back Scroll to Topexpand_less

Find below a list of returned parameters

ParameterDescription
MNP_IDSMSGlobal Unique MNP ID
MSISDNMSIDSN (mobile no)
NETWORK_CODEYour SMSGlobal password
MOBILE_LOCATIONMSC currently serving the handset.
COUNTRY_NAMECountry of carrier
COUNTRY_ISOCountry ISO
CARRIERCarrier Trading Name
CARRIER_NAMECarrier Name
CARRIER_TYPEType of Carrier
PORTEDWhether the number has been ported
Loading Form