Nederland 
United Kingdom 
United States 
Deutschland 
España 
France 
België 
Canada 
Australia 
New Zealand Lookup
Use Lookup to clean and update your database. Retrieve accurate, detailed information about any phone number in the world.
Enter a phone number
Lookup response
{
"href": "https://rest.messagebird.com/lookup/31642657439",
"countryCode": "NL",
"countryPrefix": 31,
"phoneNumber": 31642657439,
"type": "mobile",
"formats": {
"e164": "+31642657439",
"international": "+31 6 42657439",
"national": "06 42657439",
"rfc3966": "tel:+31-6-42657439"
}
}HLR response
Paid service
{
"id": "8ef675d0356ab9c92bf1e58h84795537",
"href": "https://rest.messagebird.com/hlr/8ef675d0356ab9c92bf1e58h84795537",
"msisdn": 31610948431,
"network": 20408,
"reference": null,
"details": {
"status_desc": null,
"imsi": "204080010948431",
"country_iso": "NLD",
"country_name": "Netherlands",
"location_msc": "316530",
"location_iso": null,
"ported": 0,
"roaming": 0
},
"status": "active",
"createdDatetime": "2017-05-31T09:10:24+00:00",
"statusDatetime": "2017-05-31T09:10:24+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 complete your number information and inform you of availability and provider.
Most Advanced Features
Free service
Lookup
Managing phone numbers can get messy. Our free-to-use Lookup service can help you keep things organized by validating numbers and formats, and reduce the amount of messages you send to numbers that are no longer active.
Number format
Find out whether numbers are formatted correctly and format them according to known standards like the national format or E.164. Additionally, filter out numbers that are too long, too short or contain unsupported characters.
Number info
Find out whether your numbers are landlines, mobile numbers or VoIP.
Paid service
Lookup + HLR
MessageBird has its own connection to the SS7 network. This enables us to send an SRI request to retrieve information from the HLR of the network that a number is active on at that point in time. We retrieve the following information.
MCC & MNC
Find out which country a number belongs to and on which mobile network it is currently registered.
Location IMSI
When a number is visiting in another country this is called roaming. The IMSI provides the current location of a mobile number.
Number Validity
Find out whether the number is currently active, deactivated or was never registered.
MSC
Find out whether a subscriber is roaming, which country they are roaming in, and which network they are currently logged on to.
Easily integrate our REST API
Integrate our SMS, Chat & Voice solutions within your CRM software, website or app. Read our information for developers and connect to over 900 operators worldwide.
Visit the developer docs ⇢
Serious support
Lean on us
We care about keeping our customers happy, so please reach out to us with your questions, comments and suggestions!
Contact our support team ⇢Pricing
Only pay for what you need
Free
Lookup requests
$0.010
per requestLookup + HLR requests
