{"uid":"cap_jxMX_DYDmeQO8UN-vXiVG","slug":"hubvibe-phone-number-validation-lookup-4c063c6a","name":"HubVibe Phone Number Validation & Lookup","description":"Phone number validation and lookup: valid or not, country and area, the carrier the range was issued to, line type (mobile, landline, toll-free, VoIP, premium), time zones and E.164, international and national formats, from Google's libphonenumber numbering plans. Nothing is dialled and the owner is never looked up. Input: number; optional region for a national-format number.","url":"https://hubvibe-io.com/work/phone/parse?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"number":{"type":"string","maxLength":40,"minLength":3},"region":{"type":"string","pattern":"^[A-Za-z]{2}$"},"language":{"type":"string","pattern":"^[A-Za-z]{2,3}(-[A-Za-z0-9]{2,8})*$","maxLength":35}}},"responseSchema":{"type":"json","example":{"result":{"e164":"+442070313000","input":{"number":"+44 20 7031 3000","region":"GB"},"notes":[],"valid":true,"region":"GB","carrier":"T-Mobile","country":"United Kingdom","location":"London","national":"020 7031 3000","possible":true,"line_type":"fixed_line","checked_at":"2026-09-26T18:00:00Z","time_zones":["Europe/London"],"country_code":44,"international":"+44 20 7031 3000","metadata_version":"9.0.40"},"status":"ok","worker":"phone.parse","price_usd":0.02,"provenance":{"steps":[{"ms":312,"ok":true,"step":"quote","reason":"provider_timeout","provider":"coinbase-advanced-trade-public"}],"attempts":1,"elapsed_ms":340,"providers_used":["coinbase-advanced-trade-public"]},"receipt_id":"rcpt_9f1c2b3a4d5e6f70","attribution":[{"url":"https://translate.google.com","text":"Translated by Google"}],"receipt_url":"/work/receipts/rcpt_9f1c2b3a4d5e6f70"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.02","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.02/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.02","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_fznFEFZB9oLD0EIsyAKle","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.02","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates and parses a phone number using Google's libphonenumber, returning validity, country, carrier, line type, time zones, and formatted representations without dialing or owner lookup.","exampleAgentPrompt":"Can you validate the phone number +14155552671 and tell me whether it's a mobile or landline, which carrier the range was originally issued to, what country it belongs to, and give me the E.164 and international formats?","exampleUseCases":[{"title":"Validate user-submitted phone at signup","prompt":"Before we store this phone number a new user just entered — +447911123456 — can you check if it's valid, what type of line it is (mobile, landline, VoIP, etc.), and what country it belongs to?"},{"title":"Detect VoIP numbers to block fraud","prompt":"I have a phone number submitted in our checkout form: +12025551234. Can you tell me if it's a VoIP number, which carrier range it was issued to, and whether it's actually a valid US number?"},{"title":"Format a national number for an SMS campaign","prompt":"I have the national-format number 0171 1234567 from Germany — can you parse it with region code DE and give me back the E.164 and international formats, plus confirm it's a mobile line?"}],"resultDescription":"Returns whether the phone number is valid, the country and area it belongs to, the carrier the number range was issued to, the line type (mobile, landline, toll-free, VoIP, or premium), associated time zones, and the number formatted in E.164, international, and national formats. Does not dial the number or reveal the subscriber's identity.","failureModes":["Invalid or unparseable number string returns a not-valid result with no carrier or type data","Missing region code for a national-format number (without country prefix) may cause incorrect parsing or invalid result","Unsupported region code returns an error or invalid parse","Number within valid format but unassigned range returns valid structure but indeterminate carrier","Network or service errors return HTTP error codes"],"whenToPreferThis":"Choose this endpoint when you need to validate, parse, or classify a phone number without making a live network query or revealing subscriber identity. It is ideal for form validation, fraud screening (detecting VoIP/premium numbers), formatting numbers for SMS or CRM systems, and enriching user records with country, carrier, and line-type metadata. Prefer it over live HLR lookup services when privacy or cost is a concern and real-time portability data is not required.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-01T06:41:46.478Z","isFirstParty":false,"canonicalSlug":"hubvibe-phone-number-validation-lookup-4c063c6a"}