Phone Number Lookup API
Make customer intelligence work for your business
Drive customer conversations knowing you have them engaged. Access valuable customer number intelligence with Bandwidth’s Phone Number Lookup API to make the most of each connection.
POST https://numbers.bandwidth.com/api/v1/accounts/9999999/tnlookup HTTP/1.1
Content-Type: application/json
Authorization: Basic dXNlcm5hbWU6cGFzc3dvcmQ=
Example: One TN Request Payload
{
"tns": [
"19196104423"
]
}
Example: Multiple TNs Request Payload
{
"tns": [
"19196104423",
"+19196104424"
]
}
A network built for developers
Bandwidth’s number lookup APIs give you the power to scale your tools, products, and applications while providing a better customer experience, all backed by our owned network with global reach.
Our support is always on and always included
- White-glove support delivered 24/7/365
- Single point of contact for all products
- 24/7 proactive Network Operations Center (NOC)
Communicate smarter with number insights
Connect with customers the way they like while optimizing your customer communication costs. Let’s talk it through.
FAQ
Bandwidth’s Number Lookup API provides carrier identification and number data like line type and country to help you make the most out of your number database.
Bandwidth’s number look-up API is for businesses looking to gather end-user number intelligence. It cannot be tried for free by individuals for personal use cases.
At this time we are only pulling from the US. If you are interested in international number lookup, please let your Bandwidth representative know.
Many number databases have no way of validating that a number is capable of receiving messages or if the number was entered correctly. Lookup helps you know ahead of sending which numbers aren’t capable of receiving SMS, allowing you to improve your deliverability rates.
See our pricing page for details.
Simply contact your Bandwidth representative or request to talk to an expert.
Our API returns the following information:
- E.164 formatted telephone number
- Formatted telephone number
- Country
- Line type (e.g. wireless vs wireline)
- Line provider
- Mobile country code (if applicable)
- Mobile network code (if applicable)
Our API lets enterprise users identify the network behind phone numbers. Carrier lookup has a variety of business uses such as determining differences in throughput, types of use cases allowed, filtering rules, and better predict cost when messaging via 10DLC.
Bandwidth’s number lookup API will not fit with individual number lookup use cases.