{"uid":"cap_xzOrSpTgE8FaWtKWic2xQ","slug":"phone-number-carrier-line-type-lookup-libphonenumber-40a50588","name":"Phone Number Carrier & Line Type Lookup (libphonenumber)","description":"Parses an international phone number (E.164), checks it against Google's open libphonenumber metadata, and returns the country, line type (mobile, fixed line, fixed-or-mobile, VoIP, toll free, premium, pager and more), E.164/international/national formats and the carrier that the number range was originally allocated to. Not a live HLR query: ported numbers keep the original carrier and active/inactive status is not checked.","url":"https://api.fadeandco.workers.dev/api/agent-intel/phone-carrier-hlr-lookup?utm_source=zero.xyz","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET"],"type":"string"},"queryParams":{"type":"object","required":["number"],"properties":{"number":{"type":"string","description":"Phone number in international form with country code, e.g. +905321234567 or 00442079460000"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"e164":"+905321234567","note":"Offline range data (libphonenumber), not a live HLR lookup: it cannot tell whether the line is active or ported.","input":"+905321234567","valid":true,"region":"TR","source":"https://raw.githubusercontent.com/google/libphonenumber/master/resources/PhoneNumberMetadata.xml","carrier":"Turkcell","formats":{"e164":"+905321234567","national":"0532 123 45 67","international":"+90 532 123 45 67"},"lineType":"MOBILE","checkedAt":"2026-10-23T09:35:22.990Z","carrierPrefix":"+9053","nationalNumber":"5321234567","numberPortability":"Region allows porting: the carrier is the original range holder and may have changed.","countryCallingCode":90}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_klMH8Gy7OASibCOAxumz0","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Parses an international phone number and returns its country, line type, formatted variants, and originally-allocated carrier using Google's libphonenumber metadata — no live HLR query.","exampleAgentPrompt":"Can you look up +905321234567 and tell me what country it's from, whether it's a mobile or landline number, and which carrier was originally assigned to that number range?","exampleUseCases":[{"title":"SMS channel pre-qualification check","prompt":"Before we send the marketing SMS blast, can you check whether +442079460000 is actually a mobile number or a fixed line? I need to know the line type and country so we can decide which channel to use."},{"title":"Fraud triage on signup phone","prompt":"A user just signed up with the number +18005551234 — can you tell me if it's a toll-free or VoIP number and which carrier range it was originally assigned to? I want to flag suspicious number types before approving the account."},{"title":"CRM phone number normalization","prompt":"I have this phone number from a European lead: 00442079460000 — can you parse it into proper E.164, international, and national formats and tell me which country and carrier it belongs to?"}],"resultDescription":"A JSON object containing: valid flag, E.164/international/national formatted phone strings, region code (e.g. TR), country calling code (e.g. 90), national number, line type (MOBILE/FIXED_LINE/VOIP/TOLL_FREE/PREMIUM_RATE/PAGER/FIXED_LINE_OR_MOBILE), carrier name, carrier prefix, number portability note, data source URL, and a timestamp. Includes a prominent note that this is offline range data and cannot detect porting or active/inactive status.","failureModes":["Invalid or unparseable phone number returns valid:false with no carrier or line type data","Missing required 'number' query parameter returns an error response","Numbers from regions without libphonenumber metadata may return incomplete carrier or line type data","Ported numbers will show the original range carrier, not the current carrier — this is by design and noted in the response","Premium/toll-free/pager classifications may vary by region due to metadata completeness"],"whenToPreferThis":"Choose this endpoint when you need fast, offline phone number classification — country, line type, and original carrier — from libphonenumber metadata, without needing live network status or real-time HLR queries. Ideal for pre-send SMS channel validation, fraud screening of VoIP/toll-free numbers at signup, and CRM phone normalization. Prefer it over live HLR services when cost, latency, or privacy constraints make real-time carrier lookups undesirable, and when knowing whether a number is active or ported is not required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-29T00:34:03.388Z","isFirstParty":false,"canonicalSlug":"phone-number-carrier-line-type-lookup-libphonenumber-40a50588"}