Look Up Phone Number Carrier and Line Type with Python<br>_[data-state='open'])_>_*:not([data-state='open'])_&]:text-gray-inactive header-md:[[data-state='open']_&]:dark:text-cream max-header-md:typography-h3-mobile">Products_[data-state='open'])_>_*:not([data-state='open'])_&]:text-gray-inactive header-md:[[data-state='open']_&]:dark:text-cream max-header-md:typography-h3-mobile">Solutions_[data-state='open'])_>_*:not([data-state='open'])_&]:text-gray-inactive header-md:[[data-state='open']_&]:dark:text-cream max-header-md:typography-h3-mobile">Pricing_[data-state='open'])_>_*:not([data-state='open'])_&]:text-gray-inactive header-md:[[data-state='open']_&]:dark:text-cream max-header-md:typography-h3-mobile">Why Telnyx_[data-state='open'])_>_*:not([data-state='open'])_&]:text-gray-inactive header-md:[[data-state='open']_&]:dark:text-cream max-header-md:typography-h3-mobile">Resources_[data-state='open'])_>_*:not([data-state='open'])_&]:text-gray-inactive header-md:[[data-state='open']_&]:dark:text-cream max-header-md:typography-h3-mobile">Developers<br>_[data-state='open'])_>_*:not([data-state='open'])_&]:text-gray-inactive header-md:[[data-state='open']_&]:dark:text-cream">Contact us_[data-state='open'])_>_*:not([data-state='open'])_&]:text-gray-inactive header-md:[[data-state='open']_&]:dark:text-cream">Log in<br>_[data-state='open'])_>_*:not([data-state='open'])_&]:text-gray-inactive header-md:[[data-state='open']_&]:dark:text-cream">Contact us_[data-state='open'])_>_*:not([data-state='open'])_&]:text-gray-inactive header-md:[[data-state='open']_&]:dark:text-cream">Log inSign upOpen menu

Back to blog&]:translate-x-xxs ml-xxs [.link-rtl>&]:order-[-1] [.link-rtl>&]:ml-[0] [.link-rtl>&]:mr-xxs [.link-rtl:hover>&]:-translate-x-xxs"><br>Telnyx<br>Look Up Phone Number Carrier and Line Type with Python

By Harpreet Singh Seehra

svg]:w-full [&>svg]:h-full">svg]:w-full [&>svg]:h-full">svg]:w-full [&>svg]:h-full"><br>div:first-child_p:first-child]:mt-[0px] [&>div:first-child_h2:first-child]:mt-[0px] [&_p:first-of-type]:mt-[0px] sm:col-span-8 md:col-[5/13]">A phone number carrier lookup identifies the current network operator, line type, number type, and portability status tied to a phone number. Developers use it to decide whether a number can receive SMS, whether a call should route to an agent, and whether contact data is current before the first message or call goes out.<br>The Telnyx span]:typography-paragraph md:[&>span]:typography-paragraph-md" style="color:#00C894;text-decoration:none;border-bottom:1px solid rgba(0,227,170,0.3)" href="https://telnyx.com/products/number-lookup">Number Lookup API returns carrier, line type, and portability data for any phone number in a single request, using Telnyx carrier network data rather than only a third-party reseller feed. This walkthrough builds a Python Flask service that wraps that API with a 24-hour in-memory cache so repeat lookups are fast and do not create repeat API calls during the TTL.<br>The full code is available in the Telnyx code examples repo: span]:typography-paragraph md:[&>span]:typography-paragraph-md" href="https://github.com/team-telnyx/telnyx-code-examples/tree/main/phone-number-lookup-python" rel="noopener noreferrer" target="_blank" style="color:#00C894;text-decoration:none;border-bottom:1px solid rgba(0,227,170,0.3)">phone-number-lookup-python&]:translate-x-xxs ml-xxs [.link-rtl>&]:order-[-1] [.link-rtl>&]:ml-[0] [.link-rtl>&]:mr-xxs [.link-rtl:hover>&]:-translate-x-xxs">.<br>Build a phone number carrier lookup with Python<br>The Flask app exposes three endpoints:<br>thead+tbody>tr]:first:m-0 [clip-path:inset(0_-100vmax)] shadow-[0_0_0_100vmax_var(--table-bg)] md:[clip-path:none] md:shadow-none bg-green text-black mt-[0px]! table-auto border-collapse max-md:[clip-path:inset(0)] [&_th]:text-left [&_td]:text-left [&_td]:align-top max-md:[&_td]:px-sm max-md:[&_th]:px-sm mx-none! md:mx-auto" style="--table-bg:var(--color-green);width:100%;border-collapse:collapse">MethodPathPurposePOST/lookupLook up a number from a JSON bodyGET/lookup/Look up a number from the URL pathGET/cache/statsInspect the in-memory cache

When a lookup request arrives, the app checks the cache first. On a cache miss, it calls the Telnyx Number Lookup API, extracts carrier name, carrier type, line type, number type, and portability status, then returns a clean JSON response. Cached responses include from_cache set to true.<br>Products used<br>Number Lookup is a single API call: GET /v2/number_lookup/{phone_number}. There are no webhooks, no long-running jobs, and no polling. For endpoint details, see the span]:typography-paragraph md:[&>span]:typography-paragraph-md" href="https://developers.telnyx.com/docs/identity/number-lookup" rel="noopener noreferrer" target="_blank" style="color:#00C894;text-decoration:none;border-bottom:1px solid rgba(0,227,170,0.3)">Number Lookup guide&]:translate-x-xxs ml-xxs [.link-rtl>&]:order-[-1] [.link-rtl>&]:ml-[0] [.link-rtl>&]:mr-xxs [.link-rtl:hover>&]:-translate-x-xxs">.<br>Note:...