The Number Validation API Referenced in this document may not be available on your account, please speak to your Account Manager to ensure you are setup to use this feature.
Tall Bob allows API users to validate mobile numbers using the endpoint Mobile Lookup. The mobile number provided is validated and then queries using an HLR request (Home Location Register). The main advantage of using this endpoint is to ensure message deliverability.
What is HLR?
HLR stands for Home Location Register, a database maintained by mobile network operators that stores information about subscribers and their phone numbers. Verifying mobile numbers can help companies improve the accuracy of their customer data, reduce costs associated with undeliverable messages, and prevent fraud.
Mobile Number validation is done for three major scenarios:
Checking Number Length and Format
This is done by validating the IMSI of the provided mobile number. This is done to ensure that the mobile number is entered correctly into the system. The IMSI is a 15-digit number that carries information about the country code, network code and subscription identification number
IMSI (International Mobile Subscriber Identity) = MCC (Mobile country code) +MNC (Mobile network code) +MSIN (Mobile Subscription Identification number)
Checking Number Portability
This type of validation is done to check for scenarios where the subscriber decides to keep the old number but move to a different operator
Checking if the number is in Roaming
This validation is essential as this would help in preventing fraudulent actions towards the user’s accounts
Common use cases
The common cases that would require the use of the mobile number validation endpoint would be:
- To fix bad formatting and numbers
- To validate what numbers are still live
- To enrich your database with accurate and complete mobile information.
How is it done?
- The user inputs a mobile number in the endpoint Mobile Lookup to verify the number.
- The API returns a response with ‘true or false’ to confirm if the Mobile number is Valid
- if the number is invalid, it will include a reason in the 'Status' field
By default, this endpoint returns a simple confirmation. of the validity of the phone numbers status, if you require additional information such as:
- Roaming Status
- Current Service Provider
- Ported Status
Error Messages
The status value is ‘Invalid’ when:
- The mobile number entered is too short
- The number is invalid
- The subscriber is unknown/absent
- The service is restricted by the destination network etc.
Was this article helpful?
That’s Great!
Thank you for your feedback
Sorry! We couldn't be helpful
Thank you for your feedback
Feedback sent
We appreciate your effort and will try to fix the article