APIHub
Back to Explore

Twilio - Lookups

This is the public Twilio REST API.

Telecom
basic
HTTPS
CORS: Unknown
Visit official documentation

Latency

Not monitored yet

Uptime

Not monitored yet

Playground

Verified

live

Endpoints

REST · JSON
GET

/v1/PhoneNumbers/{PhoneNumber}

  • PhoneNumber (path, required) — The phone number to lookup in [E.164](https://www.twilio.com/docs/glossary/what-e164) format, which consists of a + followed by the country code and subscriber number.
  • CountryCode (query) — 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 when the phone number is provided in a national format.
  • Type (query) — The type of information to return. Can be: `carrier` or `caller-name`. The default is null. Carrier information costs $0.005 per phone number looked up. Caller Name information is currently available only in the US and costs $0.01 per phone number looked up. To retrieve both types on information, specify this parameter twice; once with `carrier` and once with `caller-name` as the value.
  • AddOns (query) — 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](https://www.twilio.com/docs/add-ons).
  • AddOnsData (query) — Data specific to the add-on you would like to invoke. The content and format of this value depends on the add-on.

1 endpoint auto-detected

Authentication

This API uses Basic authentication (a username and password).

curl -X GET \
  "https://lookups.twilio.com/v1/PhoneNumbers/{PhoneNumber}"

lookups.twilio.com · HTTPS only