The MNP Lookup service is easy to integrate into your own systems by issuing a HTTP GET request in the programming language of your choice.

Connectivity

Connectivity to the service is via the Internet at either of the following URLs:

• http://lookup1.paradigmone.com.au
• http://lookup2.paradigmone.com.au

If one of these is unavailable for any reason, then you would simply switch to using the other one.

Authentication is performed at the network level, in that only pre-arranged IP addresses will be able to access the service via our firewalls.

Request / Response

Any number of programming languages can be used to make a HTTP GET request, and we show a few of these in the examples below.

The HTTP request should include the parameter serviceNumber containing the mobile number you wish to lookup.

For a valid request, the response will be a 4 digit CAC (Carrier Access Code). These CACs are shown below along with the associated mobile carrier name.

• 1411 (Telstra)
• 1415 (Vodafone)
• 1425 (Hutchison)
• 1431 (Hutchison 3G)
• 1450 (Globalstar)
• 1456 (Singtel Optus)
• 1469 (Lyca Mobile)

Examples

An example of accessing the service via a web browser (say for connectivity testing).

An example written in the Ruby programming language.

An example written in the Java programming language.

Errors

Valid requests will have a HTTP return code of 200. If the request is not valid, the HTTP return code will either be 400 (Bad Request) or 404 (Not Found) and will contain suitable error text to identify the problem. These 2 errors indicate a problem with the request and not a problem with the lookup server. For all other errors, or if the server does not respond, then you should try the other lookup server.

You will only be billed for valid requests (those where the HTTP return code is 200).