Knowledgebase | Forums/Mobile Messaging/Gateway - Mobile Messaging

HLR Lookup - Number Portability Lookup (Network Services - IMSI Lookup)

Jon
posted this on February 02, 2011 10:53

HLR Lookup - Number Portability Lookup (Network Services - IMSI Lookup) 

Full API available via http://wiki.txtnation.com/wiki/HLR_Number_Lookup_API#Introduction

Using txtNation to perform a HLR Lookup you can determine the mobile network of any mobile number. It also identifies disconnected, invalid, or non-mobile numbers, and can also used to look at what country a mobile subscriber is roaming in at any given time. 

HLR Lookup (Home Location Register), is also known as Number Portability Lookup and an 'IMSI' lookup or 'IMSI' query. The IMSI (International Mobile Subscriber Identity) is a 15-digit code used to identify an individual mobile user on the mobile network.

To connect and operate a HLR Lookup with txtNation you can use HLR Lookup found in our API.


 
Also known as an 'IMSI' lookup or 'IMSI' query, the HLR Lookup is the best way to determine the home network of a mobile user. HLR can also used to look at what country a mobile subscriber is roaming in at any given time.
 
The IMSI (International Mobile Subscriber Identity) is a 15-digit code used to identify an individual mobile user on the mobile network.
The IMSI consists of three components all of which can be flagged via our HLR lookup services:
Mobile Country Code (MCC)
Mobile Network Code (MNC)
Mobile Subscriber Identity Number (MSIN)
Note: The IMSI is located in the SIM.
Read more about HLR: IMSI Query and HLR Lookup.
This service is available for all customers. This is an  international service with worldwide coverage.

The IMSI consists of three components all of which can be flagged via our HLR lookup services:

  • Mobile Country Code (MCC)
  • Mobile Network Code (MNC)
  • Mobile Subscriber Identity Number (MSIN)

Note: The IMSI is located in the SIM.

This service is available for all customers. This is an  international service with worldwide coverage.


**Please note not all MVNO's are supported with HLR Lookup.

Read more on our Mobile Number Portability Lookup overview, with examples:

http://clients.txtnation.com/entries/21436098-hlr-lookup-overview-of-our-mobile-number-portability-lookup

 

The two main types of HLR Lookup can also bee shown below in examples:

i) HLR MNP Lookup (NPLU):

Provides MNC and MCC Codes with full validation and response codes. Number Portability Lookup.

 
Number Portability Lookup: 
Client can get:
result=<result>;imsi=<mccmnc>
Result Description
OK The request was successful
CALL_BARRED The service is restricted by the destination network
ABSENT_SUBSCRIBER_SM The subscriber is absent
UNEXPECTED_DATA_VALUE An unexpected data value in the request
SYSTEM_FAILURE A system failure occurred in the HLR
REQUEST_THROTTLED Maximum ongoing requests exceeded
IMSI_LOOKUP_BLOCKED Request is blocked
Mandatory parameter msisdn not found Some mandatory parameter are missing in the request
MSISDN range is not accepted The number are not allowed on this service
msisdn is invalid Wrong format of the MSISDN parameter
bad username/password Username or Password invalid
 
We do not send (or receive):
 
    timezones, country information, etc.
 
 


ii) HLR Real time Lookup (RTLU):

Provides MNC, MCC and also the IMSI and MSC, with full validation and response codes. IMSI Lookup.

 

NPLU (primarily DB's) is designed to allow customers to send prefix lookups and supply the block level information that is available in the application. Therefore there is no validation on the length of the MSISDN as it is designed to confirm the prefix.

 


 

For clients that want advanced validation they are better suited to RTLU.

 

Real time HLR Lookup

You receive the IMSI as below example:
Real time
result=OK;imsi=240084602030000;location=46
As an example
i.e. Full IMSI + Roaming Country

Note: With RTLU for HLR, you do 'not' get the full global title
We do not pass across the full global tile of the MSISDN due to potential fraud.

e.g.: Real time
result=OK;imsi=240084602030000;location=46;globaltitle=xyz
i.e. Full IMSI + Roaming Country + Global Title

If require the full Global Title of the IMISI, we require you to submit a business case to your Account Manager.

Status:
Not receiving your status reports inc. phone on or off fast enough?
The reason for this issue it due to the time it takes the  operators to update the HLR.  For all networks apart from O2 in the UK it should take around 4 hours to update, for O2 it can take up to 12 hours.  To confirm this effects handsets that have gone from being in coverage to going out of coverage, switched on to switched off.  O2 UK is particularly bad due to their HLR infrastructure, they are in the process of updating this now.
When receiving an 'Unavailable' or 'Failed' response you will be provided with an 'ErrorDescription' these can be as follows:
Absent subscriber - Number is out of coverage most likely switched off.
Call barred - Blocked by subscriber or network.
No response - Network did not respond or signalling error.
Provider Abort - Destination network signalling error/unknown or blocking.
Teleservice not provisioned - Subscription does not support SMS.