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
  • Go
  • 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!

        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!