Try out Twilio Lookup
Use the Lookup trial to perform your first phone number intelligence request.
As you run lookups, you can view the API request and response that Twilio sends. Use the Lookup API reference to build features that transfer to a fully featured account when you upgrade.
For details about trial free units, restrictions, the 30-day expiration, and post-upgrade free units, see Twilio trial account.
To get started, open the Twilio Console, go to Identity & security > Lookup > Overview, and click Try out Lookup. You can also find the Lookup overview page by clicking View all products from the Console home page.
During your Lookup trial:
- Request phone number intelligence data using Lookup packages such as Line Type Intelligence, Caller Name, and Line Status.
- Your trial starts with 100 free units that you can use to test phone numbers with different Lookup packages.
- After you upgrade, you can access pay-as-you-go usage across all Lookup packages (some packages require onboarding or approval).
You can upgrade the account at any time to remove trial limits and access phone-number intelligence from all supported regions.
On the Try out Lookup page, select the Lookup packages you want (for example, Line Type Intelligence, Caller Name, or Line Status) and enter a phone number to test.
The API request and response for your lookup appear on the page.
Review the returned intelligence data, such as carrier line type, line status, and caller name, in the trial interface to evaluate the results.
During your trial, you can use the Lookup v2 API resources with trial mode limitations. To build during your trial, copy the request from the code block on the Try out Lookup page and adjust it as needed.
You can build in trial mode, then upgrade to a fully featured account when you're ready. Once trial limitations no longer apply, you can use additional Lookup packages such as Identity Match, Reassigned Number, SIM Swap, and Line Status.
Before you begin, you need:
- A Twilio account.
- API credentials to query the Lookup API.
This request uses the Lookup v2 API endpoint. Pass the target phone number in the path and specify the requested data packages in the query parameters:
PhoneNumber: (Required) The target phone number in E.164 format.Fields: (Optional) The specific Lookup packages to request, such asline_type_intelligence,caller_name, orline_status.
The API returns formatted JSON with the requested intelligence signals:
line_type_intelligence: Carrier and line-type information (mobile, landline, or VoIP).