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=&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 :
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 |