Full API documentation: https://www.twilio.com/docs/lookup/v2-api
The Lookup API allows you to query information on a phone number so that you can make a trusted interaction with your user
Path parameters
The phone number to lookup in E.164 or national format. Default country code is +1 (North America).
Query parameters
A comma-separated list of fields to return. Possible values are validation, caller_name, sim_swap, call_forwarding, line_status, line_type_intelligence, identity_match, reassigned_number, sms_pumping_risk, phone_number_quality_score, pre_fill.
The country code used if the phone number provided is in national format.
User’s first name. This query parameter is only used (optionally) for identity_match package requests.
User’s last name. This query parameter is only used (optionally) for identity_match package requests.
User’s first address line. This query parameter is only used (optionally) for identity_match package requests.
User’s second address line. This query parameter is only used (optionally) for identity_match package requests.
User’s city. This query parameter is only used (optionally) for identity_match package requests.
User’s country subdivision, such as state, province, or locality. This query parameter is only used (optionally) for identity_match package requests.
User’s postal zip code. This query parameter is only used (optionally) for identity_match package requests.
User’s country, up to two characters. This query parameter is only used (optionally) for identity_match package requests.
User’s national ID, such as SSN or Passport ID. This query parameter is only used (optionally) for identity_match package requests.
User’s date of birth, in YYYYMMDD format. This query parameter is only used (optionally) for identity_match package requests.
The date you obtained consent to call or text the end-user of the phone number or a date on which you are reasonably certain that the end-user could still be reached at that number. This query parameter is only used (optionally) for reassigned_number package requests.
The unique identifier associated with a verification process through verify API. This query parameter is only used (optionally) for pre_fill package requests.
The optional partnerSubId parameter to provide context for your sub-accounts, tenantIDs, sender IDs or other segmentation, enhancing the accuracy of the risk analysis.
Response
OK