Level up your Twilio API skills in TwilioQuest, an educational game for Mac, Windows, and Linux. Download Now


Rate this page:

Thanks for rating this page!

We are always striving to improve our documentation quality, and your feedback is valuable to us. How could this documentation serve you better?


Reduce undeliverable messages, identify local-friendly number formats, and resolve caller names with Twilio Lookup. Find phone types, carriers, and more; Lookup allows you to programmatically get information about phone numbers so you can be as effective as possible.

curl -X GET 'https://lookups.twilio.com/v1/PhoneNumbers/+15108675310?Type=carrier' \


Get Started with Lookup

Knowing your users is only a few lines of code away. Choose your programming language and dive into the quickstart, which will get you started using Lookup in:

  • PHP
  • Python
  • Node.js
  • C#
  • Ruby
  • Java
  • cURL

Check out the Lookup Quickstart here.

Tutorials & Use Cases

1. Validation (Free)

Ensure that the provided phone number is valid. Mitigate invalid phone number inputs.

2. Formatting (Free)

Need to format +15108675310 as (510) 867-5310 for display? Lookup helps with that for local and international use.

3. Carrier Name & Type

Identify a number's carrier and determine whether the number is landline, mobile, or VoIP.

4. Caller Name

Look up the name of the number's owner, if available (U.S. only).

Build Your App

API Reference

Dive deeper into Lookup with our REST API reference and code samples.

Rate this page: