Phone Number Lookup API

With Bandwidth's Phone Number Lookup API you can quickly and easily get carrier identification and wireless status information on U.S. and Canadian-based phone numbers to better target how you connect with and send communications to your customers.

Talk to an expert

Knowledge is power

Make informed, strategic decisions about how you communicate with your customers. Bandwidth's Phone Number Lookup API returns line type, line provider, country, and more to help you connect.

More easily predict costs & deliverability

There are lots of changes happening in the messaging industry. Carrier identification allows you to know your carrier mix before you start sending text messages, helping you to more accurately predict your costs and message deliverability rates.

Send messages to numbers that can receive them

You pay for every message you send, not every one that’s received. Bandwidth’s Phone Number Lookup API enables you to easily sort numbers to ensure you’re only sending to mobile phones that can receive text messages.

Provide a better security experience

Using Bandwidth’s Phone Number Lookup API enables you to target the right type of multi-factor authentication to your customers, sending voice or text message authentication based on their line type.

A network built for developers

Bandwidth’s APIs give you the power to scale your tools, products, and applications while providing a better customer experience, all backed by our nationwide carrier-grade network.

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"
  ]
}

Above is an example what a request to the phone number lookup API can look like.

We have the tools you need

Build apps that send messages, make calls, and even save lives, without any clunky telecom infrastructure—all built on and powered by our own tier-1 carrier network (yep, even the phone numbers are ours!).

Messaging API

Bandwidth offers a full suite of messaging solutions, including our SMS API, toll-free SMS, 10DLC, and short codes. Visit our Messaging API page to learn more.

Authentication API

Provide a better, more secure customer experience. Bandwidth's Authentication API enables you to send voice or SMS authentications to your customers to protect logins, secure customer information, and provide phone number validation. Learn more.

Don’t worry—our signature support is always included

We believe in a different approach to support: we focus on making sure our customers are successful. We do that with dedicated support that’s included, a support team made up of industry vets, and tools and processes to ensure customer success and satisfaction. You’ll wonder why everyone doesn’t have the same approach.

Dedicated support to help you every step of the way
An assigned single point of contact for all products
24/7 proactive Network Operations Center (NOC)
98% CSAT delivering Technical Assistance Center (TAC)
Expert business development managers to help navigate your changing telecom needs
A dedicated team of porting specialists

Get started with Bandwidth's Phone Number Lookup API

Better target calls and text messages. Talk to one of our experts to see how Bandwidth's Phone Number Lookup API can help you provide a better experience for you and your users.

Talk to an expert

Frequently asked questions

What is number lookup?

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.

Can number lookup be used on international numbers?

At this time we are only pulling from the US and Canada. If you are interested in international number lookup, please let your Bandwidth representative know.

How does lookup help with SMS deliverability?

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.

Where can I find Bandwidth pricing?

See our pricing page for details.

How do I get started with Bandwidth Phone Number Lookup?

Simply contact your Bandwidth representative or request to talk to an expert.

What information is returned by Bandwidth's Phone Number Lookup API?

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)

What is carrier lookup and what is it used for?

Our API lets users identify the network behind phone numbers. Carrier lookup has a variety of uses such as determining differences in throughput, types of use cases allowed, filtering rules, and better predict cost when messaging via 10DLC.