{"uid":"cap_u_RViSb0ch40EM_N-PSG9","slug":"phone-number-validation-normalization-libphonenumber-21389954","name":"Phone Number Validation & Normalization (libphonenumber)","description":"International phone number validation and normalization (libphonenumber): validity, country, E.164, national/international formats and line type.","url":"https://api.aventtech.com/validate/phone?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, any common format"},"country":{"type":"string","description":"Optional ISO 3166-1 alpha-2 default country for national-format input"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"e164":"+302101234567","type":"fixed_line","valid":true,"country":"GR"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.01","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":{"p10Cents":"1.0000","medianCents":"1.0000","p90Cents":"1.0000","minCents":"1.0000","maxCents":"1.0000","p95Cents":"1.0000","sampleCount":1,"varies":false,"failureChargeRate":1},"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.01/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.01","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_yJCAG_AQRNuRayQNmZ6ab","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.01","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Validates and normalizes international phone numbers using libphonenumber, returning validity, country, E.164 format, national/international formats, and line type.","exampleAgentPrompt":"Can you check whether +1 (415) 555-0198 is a valid phone number, tell me its E.164 format, what country it's from, and whether it's a mobile or landline?","exampleUseCases":[{"title":"Clean customer contact data for CRM","prompt":"I've got a batch of phone numbers from our sign-up forms with lots of different formats. Can you validate each one, normalize them to E.164, and tell me if any are mobile numbers so we can segment our outreach?"},{"title":"Verify phone numbers before SMS campaigns","prompt":"Before we send out our SMS campaign, I need you to check all these phone numbers are actually valid and tell me which ones are mobile lines versus landlines, since we only want to text mobile users."},{"title":"Identify international callers by location","prompt":"We're getting calls from all over the world with numbers in different formats. Can you parse these phone numbers and tell me what country each one is from, whether they're real, and what type of line they are?"}],"resultDescription":"Returns a structured object including: whether the phone number is valid, the parsed country (ISO code and name), the E.164 canonical form (e.g. +14155550198), the national format, the international format, and the line type (mobile, landline, VoIP, toll-free, etc.).","failureModes":["Missing 'number' query parameter returns a 400 error","Unparseable or gibberish input returns invalid=true with no country or format data","Ambiguous national-format number without a 'country' hint may fail to resolve correctly","Very new or unusual number ranges may not be recognized by the underlying libphonenumber library","Payment not included or rejected returns a 402 Payment Required response"],"whenToPreferThis":"Use this endpoint when you need authoritative, library-grade phone number validation backed by Google's libphonenumber — the industry-standard parser trusted by major platforms. Prefer it over regex-only validators when you need line type detection, E.164 normalization, or reliable country identification across international formats.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-10T18:40:26.355Z","isFirstParty":false,"canonicalSlug":"phone-number-validation-normalization-libphonenumber-21389954"}