---
title: "Fetch information about a phone number"
method: GET
path: "/v1/PhoneNumbers/{PhoneNumber}"
tags: ["LookupsV1PhoneNumber"]
---

# Fetch information about a phone number

`GET /v1/PhoneNumbers/{PhoneNumber}`

Fetch information about a phone number. You can use this endpoint to retrieve the carrier and caller name for a phone number, as well as any installed Add-ons.

## Path parameters

- `PhoneNumber` string, required

## Query parameters

- `CountryCode` string
- `Type` string[]
- `AddOns` string[]
- `AddOnsData` object

## Response `200`

OK

- LookupsV1PhoneNumber
  - `caller_name` unknown
  - `country_code` string, nullable — The [ISO country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) for the phone number.
  - `phone_number` string, phone-number, nullable — The phone number in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number.
  - `national_format` string, nullable — The phone number, in national format.
  - `carrier` unknown
  - `add_ons` unknown
  - `url` string, uri, nullable — The absolute URL of the resource.

---

[API](https://skmtc.net/twilio/apis/twilio-lookups.md) · [All operations](https://skmtc.net/twilio/apis/twilio-lookups/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/twilio/twilio-lookups/revisions/5f405e91094a/schema)