{"uid":"cap_8565xbJgULIK3pvA-uFHb","slug":"invoket-phone-resolve-hlr-lookup-phone-number-intelligence-3f9258c2","name":"Invoket Phone Resolve — HLR Lookup & Phone Number Intelligence","description":"Before your agent sends an OTP or SMS: check the number is active and reachable and assess fraud risk — SIM-swap and port-out (MNP) signals, SMS deliverability, non-fixed VoIP and disposable-number flags from a live carrier-network HLR lookup (active line, current carrier, roaming)","url":"https://api.invoket.com/phone/resolve?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","HEAD","DELETE"],"type":"string"},"schema":{"type":"object"},"headers":{"type":"object","additionalProperties":{"type":"string"}},"queryParams":{"type":"object","additionalProperties":{"type":"string"}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":null,"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.024","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"settled","requiresHandshake":false,"reviewCount":1,"rating":{"score":"0.08","successRate":"0.00","reviews":1,"stars":"1.3","state":"rated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.024/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.024","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.024","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_n8RvTm7krNj5aBpg4WWZO","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.024","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Resolves a phone number via live HLR lookup to return carrier, line type, validity, activity status, porting info, and risk signals","exampleAgentPrompt":"Can you do a live carrier and risk check on the phone number +33612345678 — I need to know if it's active, what network it's on, whether it's been ported recently, and if it's flagged as VoIP or high risk?","exampleUseCases":null,"resultDescription":"Returns a JSON object with: E.164-normalized phone number, validity flag, active status, carrier details (MCC, MNC, operator name, country), line type (mobile/landline/VoIP), roaming status, MNP porting info, and a risk assessment (level, VoIP flag, recently-ported flag, absent-subscriber flag). Also includes provenance metadata: data source (hlr-lookups), freshness kind (live), and fetch timestamp.","failureModes":["Invalid or malformed phone number format — returns validation error","Number not found in HLR network — may return valid:false or absent_subscriber:true","Network timeout from HLR carrier — service may return an error or degraded result","Unsupported country or number range — carrier info may be null","Payment failure (x402) — call not executed if USDC payment is not settled"],"whenToPreferThis":"Use this endpoint when you need real-time, live HLR data about a phone number's current network status, activity, and risk profile — especially for fraud prevention, user verification, or routing decisions. Prefer this over static number parsing libraries when you need to know if the number is currently active, has been ported, or is flagged as a VoIP/risk number.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":1,"lastUsedAt":"2026-07-10T15:15:56.490Z","lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-11T00:38:42.470Z","isFirstParty":false,"canonicalSlug":"invoket-phone-resolve-hlr-lookup-phone-number-intelligence-3f9258c2"}