# Twilio

> Get phone number line type intelligence data using Twilio Lookup V2 API.

Source: https://cotera.co/docs/reference/tools/individual-tools/twilio

---

**Authentication Type:** API Key\
**Description:** Get phone number line type intelligence data using Twilio Lookup V2 API.

***

## Authentication

To authenticate, you'll need a Twilio API key. Learn how to create one in the [Twilio documentation](https://www.twilio.com/docs/iam/api-keys/keys-in-console).

***

## Phone Number Lookup

Lookup phone number line type intelligence information.

### Get Line Type Intelligence

Retrieve line type intelligence data for a phone number including carrier, line type, and validation status.

**Operation Type:** Query (Read)

**Parameters:**

* **phoneNumber** `string` (required): Phone number in E.164 format (e.g., +14159929960)

**Returns:**

* **value** `string` (nullable): Phone number in E.164 format
* **country** `string` (nullable): Country code (ISO-2)
* **isValid** `boolean` (nullable): Whether the phone number is valid
* **lineType** `string` (nullable): Type of phone line (e.g., mobile, landline, voip)
* **carrier** `string` (nullable): Carrier name
* **callingCountryCode** `string` (nullable): Calling country code
* **nationalFormat** `string` (nullable): National format of the phone number
* **validationErrors** `array of strings` (nullable): Validation errors if any
* **mobileCountryCode** `string` (nullable): Mobile country code
* **mobileNetworkCode** `string` (nullable): Mobile network code
* **errorCode** `string` (nullable): Error code from line type intelligence

**Example Usage:**

```json
{
  "phoneNumber": "+14159929960"
}
```

***

## Common Use Cases

**Phone Number Validation:**

* Verify phone numbers before sending SMS or making calls
* Identify line types for appropriate communication channels
* Validate customer contact information during registration

**Fraud Prevention:**

* Check for VOIP numbers that might indicate fraudulent activity
* Validate carrier information for risk assessment
* Identify suspicious phone number patterns

**Communication Optimization:**

* Choose optimal communication methods based on line type
* Route calls appropriately based on carrier information
* Improve deliverability by understanding number characteristics