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

/v2/PhoneNumbers/{PhoneNumber}

  • PhoneNumber (path, required) — The phone number to lookup in E.164 or national format. Default country code is +1 (North America).
  • Fields (query) — A comma-separated list of fields to return. Possible values are caller_name, sim_swap, call_forwarding, live_activity, line_type_intelligence, identity_match.
  • CountryCode (query) — The [country code](https://en.wikipedia.org/wiki/ISO_3166-1_alpha-2) used if the phone number provided is in national format.
  • FirstName (query) — User’s first name. This query parameter is only used (optionally) for identity_match package requests.
  • LastName (query) — User’s last name. This query parameter is only used (optionally) for identity_match package requests.
  • AddressLine1 (query) — User’s first address line. This query parameter is only used (optionally) for identity_match package requests.
  • AddressLine2 (query) — User’s second address line. This query parameter is only used (optionally) for identity_match package requests.
  • City (query) — User’s city. This query parameter is only used (optionally) for identity_match package requests.
  • State (query) — User’s country subdivision, such as state, province, or locality. This query parameter is only used (optionally) for identity_match package requests.
  • PostalCode (query) — User’s postal zip code. This query parameter is only used (optionally) for identity_match package requests.
  • AddressCountryCode (query) — User’s country, up to two characters. This query parameter is only used (optionally) for identity_match package requests.
  • NationalId (query) — User’s national ID, such as SSN or Passport ID. This query parameter is only used (optionally) for identity_match package requests.
  • DateOfBirth (query) — User’s date of birth, in YYYYMMDD format. This query parameter is only used (optionally) for identity_match package requests.

1 endpoint auto-detected

Authentication

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

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

lookups.twilio.com · HTTPS only