Rate this page:


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 '' \


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:

        Thank you for your feedback!

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

        Sending your feedback...
        🎉 Thank you for your feedback!
        Something went wrong. Please try again.

        Thanks for your feedback!

        Refer us and get $10 in 3 simple steps!

        Step 1

        Get link

        Get a free personal referral link here

        Step 2

        Give $10

        Your user signs up and upgrade using link

        Step 3

        Get $10

        1,250 free SMSes
        OR 1,000 free voice mins
        OR 12,000 chats
        OR more