Call us: +45 50 322 322

Create a HLR request

HLR means "Home Location Register” and it is at the very core of the GSM network. The HLR is the core database for all mobile subscibers. With a HLR request, you can see what operator a given phone is subscribing to.

Realtime information is often important, when you send SMS message, and with a HLR request you can get to know if a given phone number is in use.

 

How to create a HLR request

You can create a HLR request directly in your browser, if you have a SureSMS account. If you don not have an account, please apply for one here : Free SMS test-account.

Use the following link to create a HLR request.

https://api.suresms.com/script/hlr.aspx?username=[username]&password=[password]&to=[phonenumber]

 

Username Your SureSMS account login Mandatory
Password Your SureSMS account password Mandatory
To The recipient of the message. (remember countrycode) Mandatory
GoLive Set to
0: If you want to know witch operator is in charge of the number
1: If you want to know if the phone number is active
Optional

Note: The parameters are NOT case senstive.

Example

If your username is Bicycle and your password is batavus, and you want to lookup the danish number 40818824, this is how the request should look like :

https://api.suresms.com/script/hlr.aspx?username=Bicycle&password=batavus&to=4540818824&GoLive=1

 

Return

The return you get back will look something like this:

COUNTRY=Denmark(+45) MCC=238 MNC=02 LOCATION=45406997 IMSI=238021900000000 OPERATOR=Telenor

You will get some codes back like MCC and MNC. You can find more about these here: wiki link. Please find an explanation about IMSI in this article.

 

Errorcodes

There are a few errorcodes that can be returned. Different errorcodes apply if you use the GoLive=1 flag. Here is a list of errorcodes that can be returned and their meaning.

Code Switch Description
ERROR100 GoLive We have a temporary problems in the connection with operators or internally.
ERROR101 Both The input parameters are not correctly parsed. Please review your request.
ERROR102 Both You don't have any credits on your account.
Not enough credits on your account. Both You need funding on your account to create the request.
I don't know you. Bye bye! Both You have used wrong username and/or password
HLR_ABORT GoLive If the number is not available in the HLR. Probably because it is a landline
ABSENT_SUBSCRIBER_SM GoLive The subscriber is not attached to a network
HLR_LOCAL_CANCEL GoLive No response for the HLR request was received
Mandatory parameter msisdn not found GoLive Some mandatory parameters are missing in the request
HLR_REJECT GoLive The HLR request was rejected
IMSI_LOOKUP_BLOCKED GoLive Request is blocked
msisdn is invalid GoLive The number(s) are not allowed on this service
SYSTEM_FAILURE GoLive A system failure occurred in the HLR
REQUEST_THROTTLED GoLive Maximum ongoing requests exceeded
UNKNOWN_SUBSCRIBER GoLive The subscriber is unknown