# Twilio - Lookups API

> Twilio - Lookups API on Apizie: 1 endpoint (GET /v1/PhoneNumbers/{PhoneNumber}) returned as clean JSON through one API key. Send your own provider key in the x-upstream-key header. Call it over REST at https://apizie.tech/v1/communication:twilio-twilio-lookups-v1/{endpoint} or from Claude, ChatGPT and Cursor through the Apizie MCP server. Free plan: 1,000 requests a month.

- Project key: `communication:twilio-twilio-lookups-v1`
- Category: Communication
- Status: byok
- Source: https://support.twilio.com
- Page: https://apizie.tech/api/communication/twilio-twilio-lookups-v1
- OpenAPI: https://apizie.tech/api/communication/twilio-twilio-lookups-v1/openapi.json

This is the public Twilio REST API.

## Endpoints

### GET /v1/PhoneNumbers/{PhoneNumber}
`GET https://apizie.tech/v1/communication:twilio-twilio-lookups-v1/fetch-phone-number` (byok)

| Parameter | Type | Required | Description |
|---|---|---|---|
| PhoneNumber | string | yes | The phone number to lookup in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the… |
| CountryCode | string | no | The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) of the phone number to fetch. This is used to specify the country… |
| Type | array | no | The type of information to return. Can be: `carrier` or `caller-name`. The default is null. Carrier information costs $0.005 per phone… |
| AddOns | array | no | The `unique_name` of an Add-on you would like to invoke. Can be the `unique_name` of an Add-on that is installed on your account. You can… |
| AddOnsData | object | no | Data specific to the add-on you would like to invoke. The content and format of this value depends on the add-on. |

## Example
```
curl "https://apizie.tech/v1/communication:twilio-twilio-lookups-v1/fetch-phone-number" \
  -H "x-api-key: $APIZIE_KEY" \
  -H "x-upstream-key: $PROVIDER_KEY"
```

## FAQ

### How do I call the Twilio - Lookups API?
Create a free Apizie key, then send GET https://apizie.tech/v1/communication:twilio-twilio-lookups-v1/fetch-phone-number with the header x-api-key. Every endpoint returns { project, data, timestamp }.

### Is the Twilio - Lookups API free on Apizie?
Yes. The Free plan includes 1,000 requests a month at 100 requests a minute, no credit card. Twilio - Lookups itself also needs your own key from twilio.com.

### Can AI agents use the Twilio - Lookups API?
Yes. Add the Apizie MCP server (https://apizie.tech/mcp) to Claude, ChatGPT, Cursor or VS Code, then ask in plain language. The agent calls run_scraper with project key communication:twilio-twilio-lookups-v1.

### What is the status of the Twilio - Lookups API?
Needs your own provider key (bring your own key)