MessageBird Logo
Mobile menu


Format examples
Format examples


Fixed line


Lookup response
    "href": "",
    "countryCode": "NL",
    "countryPrefix": 31,
    "phoneNumber": 31624718600,
    "type": "mobile",
    "formats": {
        "e164": "+31624718600",
        "international": "+31 6 24718600",
        "national": "06 24718600",
        "rfc3966": "tel:+31-6-24718600"
HLR response
    "id": "550567f721a347a8b5463474ce38162e",
    "href": "",
    "msisdn": 31624718600,
    "network": 20408,
    "details": {
        "status_desc": null,
        "imsi": "204080024718600",
        "country_iso": "NLD",
        "country_name": "Netherlands",
        "location_msc": "31653",
        "location_iso": "nl",
        "ported": 1,
        "roaming": 0
    "reference": null,
    "status": "active",
    "createdDatetime": "2018-02-06T10:30:47+00:00",
    "statusDatetime": "2018-02-06T10:30:48+00:00"

How it works

step 1

Supply our API with the phone numbers you’d like to check.

step 2

Our API performs an HLR Lookup on the mobile network and identifies the number format.

step 3

We fill in the number data, along with availability and provider.

For a contact database that’s clean, optimized, and secure

Lookup Free service

Our free-to-use Lookup service provides basic number insights to help you keep your contact numbers organized. Validate numbers and formats, eliminate fraudulent contacts, and reduce your undeliverable messages by ridding your recipient lists of inactive numbers.

Number format

Verify that your numbers are formatted correctly and adjust entry errors to ensure your messages get delivered. Filter out numbers that are too long, to short, or contain unsupported characters. Our service applies known standards such as national formats and E.164 to keep your contact lists compliant and up to date.

"formats": {
    "e164": "+31642657439",
    "international": "+31 6 42657439",
    "national": "06 42657439",
    "rfc3966": "tel:+31-6-42657439"

Number info

Classify numbers as mobile, landline or SIP.

"type": "mobile"

Lookup + HLR Paid service

Through MessageBird’s direct connection to the SS7 network, we’re able to send an SRI request to receive information from the HLR network regarding any currently active number in the world.


Identify a number’s country of origin as well as the mobile network to which it’s registered.

Location IMSI

Discover any given number’s current geolocation.

Number Validity

Establish whether a number is active, deactivated, or unregistered.

"status": "active"


Determine whether a subscriber is roaming, in which country they are roaming, and on which network they are currently registered.

"location_msc": "316530"

Why use MessageBird Lookup

Getting better acquainted with the numbers in your contact database carries a host of benefits. In addition to cutting messaging costs, Lookup enables you to organize your CRM by number type, origin countries, and other criteria for a database that’s easy to navigate.

Reduce Messaging Costs

Using Lookup can drastically reduce messaging costs for high and low volume senders alike. From highlighting numbers that are incorrectly formatted to identifying landlines to eliminating numbers that are no longer active or reachable, you’ll minimize undeliverable messages by running your contacts through our Lookup API. Validating your CRM content is the simplest way to save unnecessary costs and keep your database clean.

Easy-to-use API

Both the free and HLR versions of MessageBird Lookup are extremely easy to access and utilize. A simple call to our user-friendly REST API is all you need to retrieve detailed information on your contact numbers, with instant delivery of results for the free Lookup service and results for HLR lookups delivered within seconds of your command.

Easily integrate our REST API

Easily access our Lookup API. Read up on our developer documentation and connect your CRM software, website or app to Lookup in no time.

  • curl
  • C sharp
  • Go
  • Java
  • Node.js
  • PHP
  • Python
  • Ruby
Visit the developer docs
# Lookup example
$ curl -X GET \
-H 'Authorization: AccessKey test_gshuPaZoeEG6ovbc8M79w0QyM'

Lookup and HLR pricing

Our basic Lookup service is entirely free, and our direct connection to the SS7 network allows us to perform HLR Lookups at the lowest possible cost.

Lookup requests are free in Netherlands
Per HLR request in Netherlands
Check out all pricing
The MessageBird Difference

Global Coverage

Connect to 900+ global carriers through our fully redundant routing platform with access to extensive feature sets and more.

Speed & Deliverability

Reach customers through our low-latency, fault-tolerant telco stack, streamlined routing profiles, and global carrier network.

24/7 Support

Our offices around the world provide unparalleled support in every time zone, 24 hours a day, 7 days a week.

Fair Pricing

Our efficient, accurate software and high-volume traffic allow us to offer you the most affordable pricing options on the market.

Want to learn more about MessageBird?
Reach out to our sales team.

Cookie Settings