Skip to main content
The Telnyx Number Lookup API returns real-time data about any phone number worldwide, helping you make routing, messaging, and fraud decisions before connecting or sending.

​
What Number Lookup returns

  • Carrier information — Identify the current carrier and original network operator for any number.
  • Line type — Determine whether a number is mobile, landline, VoIP, or toll-free.
  • Portability status — Check whether a number has been ported from its original carrier.
  • Caller name (CNAM) — Retrieve the registered caller name associated with a US number.
  • National and international format — Get consistently formatted number representations.

​
Common use cases

  • Message routing — Route SMS vs. MMS based on line type and carrier capabilities.
  • Fraud prevention — Flag high-risk number types (VoIP, prepaid) during account signup or transaction verification.
  • Number hygiene — Clean contact lists by identifying disconnected, invalid, or non-mobile numbers before launching campaigns.
  • Pre-call validation — Verify number reachability before placing outbound calls to reduce wasted call attempts.

​
Get started

Quickstart

Look up your first phone number in a few lines of code.

API Reference

Full endpoint documentation with request and response schemas.