Network Lookup API

«aql messaging services» «aql voice services»


Network Lookup API

Account Login

Lost password?

	aql ®
	Award Winning Service

	aql Telecoms
	Click here to view aql's range of voice fax and Business Voice over IP telephony solutions

	New Accounts
	Signup for a starter account from only £6+VAT. If you are a business user, apply here for a free trial account

Network Reference Service

Our network lookup API can provide you with a more detailed response for your network lookups, including an indication of how the information was discovered, by sending a request via HTTP POST to either of our two gateways located at:
http://gw1.aql.com/nl/network_lookup.php or http://gw2.aql.com/nl/network_lookup.php

Identify which network is providing services to a mobile handset

Two classes of network lookup service make it possible to identify the network operator for an given mobile number.

Pricing

Service	Cost per query
OFCOM reservation reference	Free
Network reference	1 sms credit

OFCOM reservation reference service

OFCOM publish information about which mobile numbers were reserved for which provider. We provide a way for you to refer to this information programatically for free.

Please note that where a number has been ported from one provider to another, the system will inform you of the original provider rather than the current one. This is the same regardless of the different methods used to access the data.

How to identify the network provider for a given mobile number

Send a HTTP post request to either of the following gateways:

http://gw1.aql.com/nl/network_lookup.php
or
http://gw2.aql.com/nl/network_lookup.php

including these variables in your request (* denotes a required field):

username *
password *
msisdn * How should my number be formatted?
method: 1, 2 or 3 (bitmask)
method=1 : for Ofcom only lookup (Free)
method=2 : for network lookup (cost -1 premium(UK) or -1 premium(Global) credit)
method=3 : (1+2) for both Ofcom and Network Lookup
contact: 0 (zero) or 1 (one) (1 to include contact details, 0 for no details)

Possible return values

contact: Network provider contact details.
country: Country
msisdn: The mobile telephone number
nl_accuracy:
1: Live data
2: Cached within 24 hours
3: Cached information (up to 1 month old)
4: Prefix identification
9: Failed
nl_mvno: Name of Mobile Virtual Network Operator
nl_network: Network name (Network Lookup)
nl_network_code: MCC+MNC code (if nl_network undecipherable - Network Lookup)
nl_registered: If "no" means the handset is either switched off, roaming or has no signal
ofcom_area: Geographic number area code (Ofcom database)
ofcom_change_date: Date when the data last changed (Ofcom database)
ofcom_network: Network name (Ofcom database)
ofcom_tariff_note: Tariff note according to Ofcom (Ofcom database)
ofcom_use: Number usage according to Ofcom (Ofcom database)

Example Successful Lookup Responses

0: Successful lookup
accuracy: 1
msisdn: 44798XXXXXXX
country: United Kingdom
nl_network: Vodafone Ltd
ofcom_change_date: 02-1999
ofcom_network: Orange
ofcom_use: Mobile services

OR with contact

0: Successful lookup
accuracy: 2
contact: 08700746464, Vodafone Head Office, The Courtyard, 2-4 London Road, Newbury, Berkshire, RG14 1JX
country: United Kingdom
msisdn: 447881784728
nl_network: Vodafone Ltd
ofcom_change_date: 03-1999
ofcom_network: Vodafone Ltd
ofcom_use: Mobile services

OR international number

0: Successful lookup
114569 accuracy: 2
msisdn: 150XXXXXXXX
country: United States
nl_network: AT&T Wireless Services Inc.

OR UK landline

0: Successful lookup
accuracy: 4
contact: 08702257879, BT plc, 81 Newgate Street, London, EC1A 7AJ
msisdn: 441132XXXXXX
ofcom_area: Leeds
ofcom_change_date: 07-1994
ofcom_network: BT

Error responses
Any failed queries will return an error response: "status # : description"
eg: 2: Authentication error

Error Status:
0: Successful lookup
1: Insufficient route (can appear when querying a foreign destination). Click here for assistance.
2: Authentication error
3: MSISDN number error
4: Insufficient credit
9: Undefined error

Network Lookup

Following the link below will take you to our on site Network Lookup service where you can identify, through this site, the operator for a particular mobile or landline number, based on existing Ofcom information.
Network Lookup Service