Rate this page:

Lookups Guide


Twilio Lookup helps you know the details behind a phone number. Using Lookup, you can do things like:

  1. Validate and format phone numbers for local or international use
  2. Identify a number's carrier and type: landline, mobile, or VoIP
  3. Look up the name of the number's owner, if available (U.S. only)

In this guide we'll cover everything you need to start using Twilio Lookup in your own applications.

Local Development Environment

The easiest way to use Twilio Lookup is with one of Twilio's SDKs. You can find instructions for your programming language below:

Using a programming language not listed here? No worries, you can still use Twilio Lookup by hitting our REST API directly:{PhoneNumber}

All requests must use Basic HTTP Authentication. Use your Account SID as your username and your Auth Token as your password. You can find them in the Twilio Console.

Ready to go? Let's get started.

Kevin Whinnery Simon Thorpe Nikolay Rusinov David Prothero Kat King Andrew Baker
Rate this page:

Need some help?

We all do sometimes; code is hard. Get help now from our support team, or lean on the wisdom of the crowd by visiting Twilio's Stack Overflow Collective or browsing the Twilio tag on Stack Overflow.


        Thank you for your feedback!

        Please select the reason(s) for your feedback. The additional information you provide helps us improve our documentation:

        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