APIs and documentation

Network Lookup API

Introduction

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 our gateway, allowing quick integration with your own services.

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

ServiceCost per query
OFCOM reservation referenceFree
Network reference1 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://gw.aql.com/nl/network_lookup.php (or https)

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_location: The current location that the SIM is registered
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)
sms_handler: The party that handles inbound SMS on the number

Example Successful Lookup Responses

0: Successful lookup
msisdn: 44777XXXXXXX
country: United Kingdom
ofcom_network: Vodafone Ltd
ofcom_change_date: 01-1998
ofcom_use: Mobile services
nl_network: Vodafone Ltd
nl_location: United Kingdom
nl_accuracy: 1

  OR with contact

0: Successful lookup
msisdn: 44777XXXXXXX
contact: 08700746464, Vodafone Head Office, The Courtyard, 2-4 London Road, Newbury, Berkshire, RG14 1JX
country: United Kingdom
ofcom_network: Vodafone Ltd
ofcom_change_date: 01-1998
ofcom_use: Mobile services
nl_network: Vodafone Ltd
nl_location: United Kingdom
nl_accuracy: 1

  OR international number

0: Successful lookup
msisdn: 491511XXXXXXX
country: Germany
nl_network: T-Mobile Deutschland GmbH
nl_location: Federal Republic of Germany
nl_accuracy: 1

  OR UK landline

0: Successful lookup
msisdn: 44120XXXXXXX
contact: 08702257879, BT plc, 81 Newgate Street, London, EC1A 7AJ
country: United Kingdom
ofcom_area: Colchester
ofcom_network: BT
ofcom_change_date: 07-1994
 

Error responses

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

StatusDescription
0: Successful lookupSuccessful lookup
1: Insufficient routeCan appear when querying a foreign destination
2: Authentication errorIncorrect username or password
3: MSISDN number errorIncorrect MSISDN provided
4: Insufficient creditBuy more credit
5: Internal System ErrorThere was a problem with processing your request
Please report this using our support system
9: Undefined errorError without any specific description
Please report this using our support system
10: Gateway unreachableDesired network was not reachable
11: Result not parsableData was not returned in expected format
12: Data unavailableHLR data unavailable for the MSISDN
13: Unknown subscriberMSISDN is not known to the network
14: Absent SubscriberMSISDN is not currently registered to any network
15: Invalid requestUnexpected data was submitted to a network
16: System failureRequest rejected due to network or protocol failure
17: Lookup Not SupportedMSISDN does not support look ups
18: Request rejectedMSISDN is barred
19: Request AbortedIndicates temporary problem or lost reach
20: TimeoutNo response was received from a network

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


Back to Documentation and APIs

Follow us on Twitter

Like us on Facebook

Connect to us on LinkedIn

Where we are

aql
13-15 Hunslet Road
Leeds
LS10 1JQ
Telephone 01133 20 30 40