Home
Contact usLog inSign up

Number lookup API

The more you know about numbers, the more effective your communications will be. Telnyx Number Lookup finds the carrier and caller information behind each phone number. Use it to increase outbound calling productivity, improve message deliverability, and protect against spam and fraud.

Customer Logo ReplicantTalkdesk LogoPhilips LogoCisco LogoCustomer Logo ReplicantTalkdesk LogoPhilips LogoCisco Logo
DATA FIELDS

What every lookup returns

Request only the data types you want and pay per dip, not per field. Responses return in milliseconds over REST.

  • Carrier name

    The network currently serving the number, accurate after porting. HLR lookup confirms the live carrier for mobile numbers.

  • Line type intelligence

    Mobile, landline, or VoIP. Know what the number can do. Landlines can't receive SMS, VoIP numbers are higher fraud risk.

  • LRN lookup API

    Location Routing Number identifying the serving switch for routing decisions. Know who actually services a number today, not who originally issued it.

  • CNAM lookup API

    The registered caller ID name associated with the number. Attach a caller ID name to incoming calls even if the caller has never called you before.

  • Ported status

    Whether the number has moved carriers, and when. Ported number lookup reflects the actual serving carrier today, not the original carrier.

  • E.164 format & MCC/MNC

    All inputs in E.164 format for consistent processing. Mobile Country Code (MCC) and Mobile Network Code (MNC) for international carrier identification.

FEATURES

What you can do with Number Lookup API

From SMS deliverability to fraud prevention, number lookup powers the decisions your application makes about every phone number.

  • SMS deliverability

    Landlines can't receive texts, and messages sent to them still cost money. Running a lookup before sending confirms the number is mobile and identifies the carrier, so your messages reach real inboxes.

  • Fraud & spam prevention

    VoIP and virtual numbers are the tool of choice for fake signups and SMS pumping fraud. Lookup flags line type in real time, letting you block or challenge risky numbers before they enter your system.

  • Lead scoring

    A disconnected or invalid number is a dead lead. Validate numbers at the point of capture to keep your CRM clean and your sales team focused on contacts that answer.

  • Two-factor authentication

    Sending OTP codes to unverifiable numbers creates friction and cost. Phone number verification via Lookup confirms a number can receive the code before you send it, improving completion rates.

  • Call routing

    The LRN reveals which switch actually serves a number after porting. Use it to route calls efficiently and avoid misdirected traffic on your voice infrastructure.

  • Bulk number lookup

    Need to clean a database of millions of numbers? The API handles batch phone number validation at throughput rates that consumer tools can't match.

NUMBER LOOKUP vs REVERSE PHONE LOOKUP

Consumer reverse phone lookup tools answer one question for one person: who called me? Number Lookup solves a different problem. It's a phone number carrier lookup API built for businesses that need to validate numbers at scale, programmatically.

Consumer reverse lookup

Reverse phone lookup

  • Name from public records, maybe an address
  • One question for one person at a time
  • Data goes stale, pulled from public records
  • No carrier, line type, or routing data
  • No API, no programmatic access

Telnyx Number Lookup API

Number Lookup

  • Live telecom databases, including HLR lookup
  • Carrier, line type, LRN, CNAM, ported status
  • Real-time results, including recent ports
  • At scale via REST API, millions at a time
  • Pay per dip, request only the data you need
RESOURCES

Start building

Our code is your code.

cURL

curl -X GET \
  --header "Content-Type: application/json" \
  --header "Accept: application/json" \
  --header "Authorization: Bearer YOUR_API_KEY" \
  --globoff "https://api.telnyx.com/v2/number_lookup/+18665552368"

Python

import telnyx
telnyx.api_key = "YOUR_API_KEY"
telnyx.NumberLookup.retrieve("+13129457420")

Node

import Telnyx from 'telnyx';

const telnyx = new Telnyx("YOUR_API_KEY");

const { data: numberInfo } = await telnyx.numberLookup.retrieve(
  '+18665552368'
);

Ruby

require "telnyx"
Telnyx.api_key = "YOUR_API_KEY"

Telnyx::NumberLookup.retrieve('+12624755500')
PRICING

Only pay for the information you need

Our pricing is split by carrier and caller information so you can cut your costs.

Starting at:

$0.0015

per lrn dip
See pricing
PRODUCTS

Build with Number Lookup

Sign up and start building

Sign upContact sales

FAQ

Number Lookup from Telnyx is a service that allows you to input a number and receive back information about the number carrier and caller ID.

Resources, Docs, Support

Number Lookup hub

  • Article icon

    Number Lookup using Telnyx API | Telnyx

    Lookup a phone number and retrieve information. Start building on Telnyx today.

    Read more
  • Article icon

    Account | Telnyx

    The Account API allows users to manage addresses and billing info associated with their account.

    Read more
  • Article icon

    APIs glossary | Telnyx

    General terms used in the world of APIs

    Read more
  • Article icon

    Lookup phone number data API | Telnyx

    Returns information about the provided phone number.

    Read more
  • Article icon

    Overview API | Telnyx

    Leverage our APIs with our API reference documentation.

    Read more
  • Article icon

    List phone numbers API | Telnyx

    List phone numbers

    Read more
  • Article icon

    LRN lookup using HTTP API V1 | Telnyx

    Uses HTTP to retrieve the local routing number information (LRN).

    Read more
  • Article icon

    Using an HTTP Request API V1 | Telnyx

    Returns the caller information (if found) for a telephone number.

    Read more
  • Article icon

    [eBook] Build Better Customer Experience with Number Lookup

    Learn how to leverage next-generation number lookup tools to incorporate rich data about your incoming callers to your customer experience.

    Read more
  • Article icon

    Use Number Lookup Tools to Increase Lead Conversions

    Learn how to leverage Number Lookup tools to convert more leads and increase sales. Try it out today!

    Read more
  • Article icon

    Smart IVR & Conversational AI Are Better With Number Lookup

    Learn how to improve your interactive voice response system by using Number Lookup tools to feed rich customer context to your conversational AI.

    Read more
  • Article icon

    Automated International Number Search and Order

    Streamline your international number search and order process with our latest API.

    Read more
  • Article icon

    Here’s how to check if your number can be ported

    Phone number portability check in bulk. Looking for a port eligibility tool that can let you easily check up to 2,500 numbers at a time?

    Read more
  • Article icon

    5 Advanced Phone Number Searching Examples with Telnyx

    Telnyx offers the most powerful number search and purchasing APIs and portals on the market. Check out our demonstration of advanced searches.

    Read more
  • Article icon

    Using Telco Data for Lead Scoring - powered by Telnyx

    Telco data can also be used to establish context around incoming calls or verify contact information for inbound leads.

    Read more
  • Article icon

    Types of phone numbers and their business use cases

    Discover different types of phone numbers, their benefits, and which number is the best fit for your use case.

    Read more
  • Article icon

    Telnyx Blog | CPaas & UCaaS Resources

    Find data-driven research, comprehensive guides and all things SIP trunking, voice and SMS APIs, wireless and more.

    Read more
  • Article icon

    Global Numbers - The Real Facts You Need

    Instantly provision local, national and toll-free numbers globally.Make & receive calls or send SMS globally with the API built for reliable communications

    Read more
  • Article icon

    Top 5 Twilio Verify API alternatives

    Looking for the best verification API for your business? Don’t just default to Twilio Verify API. Consider some of these great options instead.

    Read more
  • Article icon

    The Better Twilio Alternative - Telnyx

    Switch to Telnyx for a better Twilio alternative. Benefit from our competitive pricing, private global network, and award-winning support.

    Read more
  • Article icon

    Your Number Lookup Guide | Telnyx Help Center

    This article will explain the Number Lookup interface on the Telnyx Mission Control portal

    Read more
  • Article icon

    The Rate Sheet and LRN explained | Telnyx Help Center

    Why a supposed Rate Sheet price may not match the actual call price or why the rate limit may trigger earlier than expected.

    Read more
  • Article icon

    Telnyx Tech Specs | Telnyx Help Center

    Here you will find out key tech specs at Telnyx and what they mean for our service.

    Read more
  • Article icon

    Number Features | Telnyx Help Center

    Discover Telnyx's number features: Voicemail, Call Forwarding, Caller ID, and more.

    Read more
  • Article icon

    Search and Buy Numbers | Telnyx Help Center

    This article describers to process of obtaining numbers through Telnyx

    Read more
  • Article icon

    The Rate Sheet and LRN explained | Telnyx Help Center

    Why a supposed Rate Sheet price may not match the actual call price or why the rate limit may trigger earlier than expected.

    Read more
  • Article icon

    Embedded Number Search (Provisioning)

    Build number searching into your application with ease using Telnyx. Our number lookup API is fast, and priced competitively.

    Read more
  • Article icon

    Caller ID Management - Integrate with Telnyx

    Use Telnyx's Caller ID management tools to route and prioritize calls and customize conversations with customers.

    Read more