--- title: Number Lookup API | Real-Time Carrier Lookup | Telnyx canonical: https://telnyx.com/products/number-lookup --- # Number Lookup API | Real-Time Carrier Lookup | Telnyx # 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. Select Country Select Country Phone Number SEARCH NUMBER Search A Valid Phone Number To Start **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') ``` cURLPythonNodeRuby **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](https://telnyx.com/pricing/number-lookup) PRODUCTS ## Build with Number Lookup * [![Global phone numbers](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/Product_Detail_Hero_Comms_Global-Numbers-fs8-fs8-e8a6507d.png?width=640&format=webp)Phone NumbersProvision local, national, and toll-free numbers globally with instant setup and full API control.Learn more](https://telnyx.com/products/phone-numbers) * [![Woman responds to text message](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/Product_Detail_Hero_Comms_SMS-API-fs8-fs8-573c8312.png?width=640&format=webp)SMS APISend and receive SMS messages globally with a developer-first API built for scale and deliverability.Learn more](https://telnyx.com/products/sms-api) * [![SIP Trunks Hero](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/Telnyx%20Global%20SIP%20Trunking%20(1000%20x%20800%20px).png?width=2250&format=webp)SIP TrunksConnect your PBX or UCaaS to the PSTN with elastic SIP trunks on a carrier-owned global network.Learn more](https://telnyx.com/products/sip-trunks) * [![Verify API Hero Asset](https://d2efw2akbx8gaf.cloudfront.net/https://dotcom-payload-assets-prod.s3.us-east-1.amazonaws.com/cms-media/Product_Detail_Hero_Comms_Verify-API-fs8-9a286473.png?width=1696&format=webp)Verify APIAdd two-factor authentication with OTP via SMS, voice, and flash calling using a single API.Learn more](https://telnyx.com/products/verify-api) ## Sign up and start building [Sign up](https://telnyx.com/sign-up)[Contact sales](https://telnyx.com/contact-us) ## FAQ ### What is Number Lookup? 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. ### How do I get started with Telnyx Lookup? ### Can I use Lookup on international numbers? ### What does LRN mean? ### Where can I find Telnyx Lookup pricing? ### What is the difference between number lookup and phone number validation? ### What is HLR lookup? ### Can I check if a phone number is active? ### How does carrier lookup work? ### What is line type intelligence? ### Can I do bulk number lookups? ### What is SMS pumping fraud and how does number lookup prevent it? **Resources, Docs, Support** ## Number Lookup hub * ### Number Lookup using Telnyx API | Telnyx Lookup a phone number and retrieve information. Start building on Telnyx today. [Read more](https://developers.telnyx.com/docs/identity/number-lookup/quickstart) * ### Account | Telnyx The Account API allows users to manage addresses and billing info associated with their account. [Read more](https://developers.telnyx.com/docs/account) * ### APIs glossary | Telnyx General terms used in the world of APIs [Read more](https://developers.telnyx.com/docs/glossary/api-glossary) * ### Lookup phone number data API | Telnyx Returns information about the provided phone number. [Read more](https://developers.telnyx.com/api/number-lookup/lookup-number) * ### Overview API | Telnyx Leverage our APIs with our API reference documentation. [Read more](https://developers.telnyx.com/api/) * ### List phone numbers API | Telnyx List phone numbers [Read more](https://developers.telnyx.com/api/numbers/list-phone-numbers) * ### LRN lookup using HTTP API V1 | Telnyx Uses HTTP to retrieve the local routing number information (LRN). [Read more](https://developers.telnyx.com/api/v1/lrn-data/get-lrn-http-request) * ### Using an HTTP Request API V1 | Telnyx Returns the caller information (if found) for a telephone number. [Read more](https://developers.telnyx.com/api/v1/cnam-data/get-cnam-http-request) * ### \[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](https://telnyx.com/resources/ebook-number-lookup) * ### 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](https://telnyx.com/resources/increase-lead-conversions-number-lookup) * ### 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](https://telnyx.com/resources/number-lookup-smart-ivr-conersational-ai) * ### Automated International Number Search and Order Streamline your international number search and order process with our latest API. [Read more](https://telnyx.com/resources/international-number-search-and-order-made-easy) * ### 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](https://telnyx.com/resources/number-portability-check-live) * ### 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](https://telnyx.com/resources/number-search-spotlight) * ### 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](https://telnyx.com/resources/using-telco-data-for-lead-scoring) * ### 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](https://telnyx.com/resources/types-of-phone-numbers) * ### 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](https://telnyx.com/resources/topic/numbers) * ### 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](https://telnyx.com/resources/fact-sheet-global-numbers) * ### 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](https://telnyx.com/resources/twilio-verify-api-alternatives) * ### 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](https://telnyx.com/the-better-twilio-alternative) * ### Your Number Lookup Guide | Telnyx Help Center This article will explain the Number Lookup interface on the Telnyx Mission Control portal [Read more](https://support.telnyx.com/en/articles/4366901-your-number-lookup-guide) * ### 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](https://support.telnyx.com/en/articles/5073043-the-rate-sheet-and-lrn-explained) * ### 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](https://support.telnyx.com/en/articles/1130599-telnyx-tech-specs) * ### Number Features | Telnyx Help Center Discover Telnyx's number features: Voicemail, Call Forwarding, Caller ID, and more. [Read more](https://support.telnyx.com/en/collections/1513234-number-features) * ### Search and Buy Numbers | Telnyx Help Center This article describers to process of obtaining numbers through Telnyx [Read more](https://support.telnyx.com/en/articles/4380325-search-and-buy-numbers) * ### 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](https://support.telnyx.com/en/articles/5073043-the-rate-sheet-and-lrn-explained) * ### 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](https://telnyx.com/use-cases/embedded-number-search-provisioning) * ### 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](https://telnyx.com/use-cases/caller-id-management) [Start building](https://telnyx.com/sign-up)