Lookup Phone Number Intelligence
- Verify
- JavaScript
- Quick Deploy
This sample deploys a web UI and a Serverless Function that together let you look up detailed intelligence about any phone number using the Twilio Lookup v2 API. Enter a phone number (with international prefix handling via intl-tel-input), select the data packages you want, and the Function queries Lookup and returns the results as JSON.
Validation and Formatting is always included and free. The remaining packages are opt-in and billed per lookup — select only what your use case needs.
- Line Type Intelligence | Whether the number is mobile, landline, VoIP, toll-free, etc.
- Caller Name | The name associated with the number (CNAM)
- SMS Pumping Risk | Risk score for SMS traffic pumping fraud
- SIM Swap* | Whether the SIM was recently swapped — useful for fraud checks
- Call Forwarding* | Whether the number has unconditional call forwarding active
- Line Status* | Whether the line is currently reachable
* Additional carrier approval required. Submit this form to request access.
For a production use case we recommend pairing this with phone verification to confirm the user actually controls the number before acting on the Lookup data.
More details in the Lookup API documentation.
