{"stats":{"calls7d":0,"successRate":null,"avgMs":null,"reviews":0,"usefulRate":null},"id":"p/hlrlookup.people.phone.verify","kind":"provider","name":"hlrlookup_people_phone_verify","description":"Check if a phone number is live. Performs a live HLR lookup, returning number type, live status, original and current network, and porting information. Warning: a national number sent without input_format can be read as another country's number (a US 617... number as an Australian 61... number), and that lookup is still charged. (HLR Lookup · People & contact data)","tags":["people","enrichment","hlrlookup","phone","live","data"],"method":"POST","path":"/v1/p/hlrlookup.people.phone.verify","url":"https://toll402.dev/v1/p/hlrlookup.people.phone.verify","specUrl":"https://toll402.dev/v1/spec/p/hlrlookup.people.phone.verify","price":"$0.01652","priceUsd":0.01652,"available":true,"inputSchema":{"type":"object","properties":{"telephone_number":{"type":"string","description":"International E.164 digits without the leading +, or a national number with input_format.","examples":["447540822872"]},"input_format":{"type":"string","description":"ISO3 country code when telephone_number is in national format, e.g. GBR. Leave unset for international input."},"output_format":{"type":"string","description":"Format of formatted_telephone_number: E164, PLUS_E164, NATIONAL, or an ISO3 country code."},"usa_status":{"type":"string","description":"Set YES only for +1 numbers. Without it a US number returns NOT_AVAILABLE_NETWORK_ONLY. A US mobile with YES costs two credits.","default":"NO","enum":["YES","NO"]},"save_to_cache":{"type":"string","description":"The result is cached only for this account, never shared.","enum":["PRIVATE"]},"cache_days_global":{"type":"integer","description":"0 never reads the shared cache, so the lookup is live.","enum":[0]},"cache_days_private":{"type":"integer","description":"0 never reads this account's cache, so the lookup is live.","enum":[0]}},"additionalProperties":true,"required":["telephone_number","save_to_cache","cache_days_global","cache_days_private"],"description":"Answers arrive in results[0]. live_status is LIVE, DEAD, ABSENT_SUBSCRIBER, NO_TELESERVICE_PROVISIONED, NOT_AVAILABLE_NETWORK_ONLY, NO_COVERAGE, INCONCLUSIVE or NOT_APPLICABLE; current_network_details names the serving network and is_ported says whether the number moved. Some networks give no live status (NOT_AVAILABLE_NETWORK_ONLY) but the lookup still costs a credit. Landlines and other non-mobi"},"example":{"telephone_number":"447540822872","save_to_cache":"PRIVATE","cache_days_global":0,"cache_days_private":0},"meta":{"provider":"HLR Lookup","providerSlug":"hlrlookup","providerDocs":"https://www.hlrlookup.com/knowledge","providerPricing":"https://www.hlrlookup.com/pricing","providerLogo":"https://www.google.com/s2/favicons?domain=www.hlrlookup.com&sz=64","platform":"people","platformLabel":"People & contact data","category":"Enrichment","capability":"people.phone.live","upstreamMethod":"POST","upstreamPriceUsd":0.013216,"pricing":"per_success","pricingNote":"One credit per live mobile lookup; a US mobile with usa_status YES costs two. Landlines, NO_COVERAGE, BAD_FORMAT, per-result errors and HTTP 4xx/5xx are free. A live mobile lookup reported credits_spent 1 and lowered the balance by one credit; a landline reported 0 and left it unchanged. A US mobile","verified":"2026-10-08","docs":"https://www.hlrlookup.com/knowledge/full-api-result","calls":0,"successRate":null,"via":"treg"}}