HLR lookup

HLR stands for Home Location Register. It is the database of a mobile network that holds the records of its subscribers. Each SIM card has a record in the HLR of its network.

An HLR lookup asks the network if a number is valid and active. It also tells you which mobile network the number is on now. Use HLR lookups to remove inactive numbers from your lists before you send. This increases your delivery rate and decreases your sending costs.

Run an HLR lookup on a list

  1. Go to Contacts > Lists and open the list.
  2. Click the Lookup tab.
  3. Click HLR Verify. The HLR Verification dialog opens on the New Request tab.
  4. Select the check box of each country that you want to check. The number in brackets shows how many numbers you can check in that country.
  5. In the field next to each country, type how many numbers to check.
  6. Look at the Estimated cost.
  7. Click Verify.

The dialog then shows the History tab. Each request shows a progress bar and the results. The tab refreshes every 10 seconds while a request runs. A lookup can take some minutes.

The HLR Verify button shows only when the list has numbers that you can check. We do not check numbers again when we already have a recent HLR result for them. These numbers do not cost you anything.

How many numbers to check

You do not always have to check the full list. We recommend this procedure:

  1. Check a sample of 10–15% of the numbers.
  2. If 75% or more of the sample is good, you can send to the list without more checks.
  3. If less than 75% is good, check all the numbers.

Results

ResultWhat it means
GoodThe number is active. Campaigns send to it.
BadThe number is not valid or not active. Campaigns do not send to it.
UnresolvedThe carrier answered but could not resolve the number. You can still send to it. You can check it again later.
FailedThe lookup did not complete, so we know nothing new about the number. It keeps its previous status, and you can still send to it.

To download the results of a request, click the download icon on its row in the History tab. You get a CSV file.

After the lookup, the Lookup tab of the list shows the new counts per country. To export only the numbers that failed, use Export HLR-rejected in the actions menu of the list. Read Manage lists.

Prices

The price per number depends on the country and on the mobile network. To see the prices:

  1. Go to Contacts > Enrichment.
  2. In the Verification coverage panel, select a country.

The panel shows each verification route for that country, its method and its price. The HLR Verification dialog always shows the estimated cost before you start.

Mobile network data

An HLR lookup also records the mobile network of each good number. This is important when you send to countries where routes perform differently per carrier. You can use the network data in two ways:

Check numbers automatically

You can tell the platform to check the numbers of a country automatically, with a daily limit and a monthly budget. Read Enrichment tools.

Check numbers with the API

To check a number from your own system, use the HLR verification API.

Need more help? Contact support.