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.
A 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.
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:
i) HLR MNP Lookup (NPLU):
Provides MNC and MCC Codes with full validation and response codes. Number Portability Lookup.
Client can get:result=<result>;imsi=<mccmnc>
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 invalidWe 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.
Real time HLR Lookup
You receive the IMSI as below example:Real timeresult=OK;imsi=240084602030000;location=46
As an examplei.e. Full IMSI + Roaming CountryNote: With RTLU for HLR, you do 'not' get the full global titleWe do not pass across the full global tile of the MSISDN due to potential fraud.e.g.: Real timeresult=OK;imsi=240084602030000;location=46;globaltitle=xyzi.e. Full IMSI + Roaming Country + Global TitleIf 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.