---
"@context": https://schema.org
"@type": TechArticle
"@id": https://www.twilio.com/docs/usage/trials/try-out-lookup#article
headline: Try out Twilio Lookup
description: Start building with a Twilio trial account. Perform your first phone number intelligence request within a few minutes.
url: https://www.twilio.com/docs/usage/trials/try-out-lookup
inLanguage: en
dateModified: 2026-09-21T19:23:35.000Z
author:
  "@type": Organization
  name: Twilio Developer Education Team
publisher:
  "@type": Organization
  name: Twilio
---

# 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](/docs/lookup/v2-api) 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](/docs/usage/trials).

To get started, open the [Twilio Console](https://1console.twilio.com/), 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.

## Step 1: Perform a lookup

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.

## Step 2: Review lookup results

Review the returned intelligence data, such as carrier line type, line status, and caller name, in the trial interface to evaluate the results.

## Use the Lookup API

During your trial, you can use the [Lookup v2 API](/docs/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.

### Prerequisites

Before you begin, you need:

* A Twilio account.
* API credentials to query the Lookup API.

### Perform a lookup request

This request uses the [Lookup v2 API](/docs/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](/docs/glossary/what-e164) format.
* `Fields`: (Optional) The specific Lookup packages to request, such as `line_type_intelligence`, `caller_name`, or `line_status`.

### Review intelligence output

The API returns formatted JSON with the requested intelligence signals:

* `line_type_intelligence`: Carrier and line-type information (mobile, landline, or VoIP).