Mobile Number Portability (MNP)

SMS Central also allow you to query our database and find out which network carrier a specified mobile phone number belongs to.
This is available via our simple-to-use Mobile Number Portability (MNP) API.

What is MNP?

Mobile Number Portability (MNP) is essentially a way to confirm some details about a given mobile number, including:

- Whether the given mobile number is an active Australian Service and

- Information on the current carrier hosting that mobile number

Why is this useful?

The MNP allows you to confirm whether a number exists and is active and also whether a mobile number has been ported from one carrier to another.

There are numerous applications for the use of this information, one of which may be to obtain the ‘provider’ field required when sending Premium SMS messages via the SMS Central SMS API.

What is the MNP API?

SMS Central provide you with an open Application Programming Interface (API) which enables you to query our MNP Database and obtain the MNP information about a given mobile number.
This is done with a simple HTTP (web) request to our MNP API Web-Service.

What Do I Need to Do?

Getting started is easy; simply call SMS Central on 1300 00 7672 and we’ll set up your account, providing you with the username and password you’ll need to start using the MNP API.
Once you have an account, it’s very simple to start using our API. In fact, it’s so simple to use our MNP API, these are all the details you’ll need to get going:

Step 1: Send a HTTP(S) web request (POST or GET) to the SMS Central MNP web service URL at:
http(s)://srs.smsc.com.au/pcm/client/mnpquery.php

Step 2: Provide the following parameters in the HTTP Web request:

Parameter

Required

Description

username

YES

Username set up by SMS Central for use of the MNP API

password

YES

Password set up by SMS Central for use of the MNP API

address

YES

Mobile Phone Number (Australian Only)

format

NO

The response format of the API. There are 3 different response type options:

  • text (default)
  • Json
  • xml

Step 3: Our MNP Web Service will provide a response in the following format (samples only):

Format

Response

Text

ADDRESS: 614XXXXXXXX PROVIDER:optus

JSON

[{“Address”:”614XXXXXXXX”,”PROVIDER”:”optus”} ]

XML

614XXXXXXXX

That’s all there really is to it. If the HTTP Request failed, it will come back with the following responses:

Error

HTTP Code

Invalid Username/Password

403 Forbidden

Invalid Mobile Number

500 Bad Request