Sign in

v50

latestOpenAPI 3.0.1Apache 2.0raw.githubusercontent.com2026-02-051220.4 KB
LookupsV1PhoneNumber

get/v1/PhoneNumbers/{PhoneNumber}

Path parameters

PhoneNumberstring required

The phone number to lookup in E.164 format, which consists of a + followed by the country code and subscriber number.

Query parameters

CountryCodestring

The ISO country code of the phone number to fetch. This is used to specify the country when the phone number is provided in a national format.

Typestring[]

The type of information to return. Can be: carrier or caller-name. The default is null. To retrieve both types of information, specify this parameter twice; once with carrier and once with caller-name as the value.

AddOnsstring[]

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 specify multiple instances of this parameter to invoke multiple Add-ons. For more information about Add-ons, see the Add-ons documentation.

AddOnsDataobject

Data specific to the add-on you would like to invoke. The content and format of this value depends on the add-on.

Response

OK

{"stackTrail":"components:schemas:lookups.v1.phone_number:properties:caller_name","oasType":"schema","type":"unknown","description":"The name of the phone number's owner. If `null`, that information was not available.","extensionFields":{"x-twilio":{"pii":{"handling":"standard","deleteSla":30}}},"nullable":true}
country_codestring nullable

The ISO country code for the phone number.

phone_numberstring phone-number nullable

The phone number in E.164 format, which consists of a + followed by the country code and subscriber number.

national_formatstring nullable

The phone number, in national format.

{"stackTrail":"components:schemas:lookups.v1.phone_number:properties:carrier","oasType":"schema","type":"unknown","description":"The telecom company that provides the phone number.","nullable":true}
{"stackTrail":"components:schemas:lookups.v1.phone_number:properties:add_ons","oasType":"schema","type":"unknown","description":"A JSON string with the results of the Add-ons you specified in the `add_ons` parameters. For the format of the object, see [Using Add-ons](https://www.twilio.com/docs/add-ons).","extensionFields":{"x-twilio":{"pii":{"handling":"standard","deleteSla":30}}},"nullable":true}
urlstring uri nullable

The absolute URL of the resource.