{"uid":"cap_iI_rpzUIt8xHcYFQj2ppu","slug":"phone-number-check-8a5d6413","name":"Phone Number Check","description":"Use when an agent needs phone number validation for CRM, KYC or calling: valid/possible, E.164 and national formats, country, type (mobile, fixed line, toll-free, VoIP...), original carrier, location and time zones, for any number worldwide. Offline, instant. $0.01 USDC on Base; charged only on 2xx, never for invalid input.","url":"https://api.facts402.com/phone?utm_source=zero.xyz","method":"POST","headers":{},"bodySchema":{"type":"object","properties":{"number":{"type":"string","title":"Number","pattern":"^[0-9+()\\-. ]{3,40}$","description":"Phone number, ideally in +E.164 form"},"default_region":{"anyOf":[{"type":"string","pattern":"^[A-Za-z]{2}$"},{"type":"null"}],"title":"Default Region","default":null,"description":"ISO country used when the number has no +prefix"}}},"responseSchema":null,"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":null,"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_eW0ocdL7tfxjeP-ZtajGC","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 normalises any phone number worldwide, returning validity, E.164/national formats, country, type, carrier, location, and time zones — entirely offline and instant.","exampleAgentPrompt":"Can you validate the phone number +447911123456 and tell me whether it's a real mobile number, what country it's in, and what its E.164 format is?","exampleUseCases":[{"title":"CRM contact data cleanup","prompt":"I've got a phone number from a new lead — +1 (415) 555-0198 — can you validate it, confirm it's mobile and not VoIP, and give me the clean E.164 format to store in our CRM?"},{"title":"KYC phone verification before onboarding","prompt":"As part of onboarding, I need to verify this user-supplied number: 07700900123, assuming they're in the UK. Is it a valid mobile number, and what carrier is it registered to?"},{"title":"Outreach eligibility check for SMS campaign","prompt":"Before we send our SMS campaign, check if the number +33612345678 is a real, reachable mobile phone — not toll-free or VoIP — and tell me the country and time zone so we can schedule it appropriately."}],"resultDescription":"Returns whether the number is valid and/or possible, the canonical E.164 format, the national format, the ISO country code, the phone type (mobile, fixed line, toll-free, VoIP, etc.), the original carrier name, the geographic location, and one or more time zone identifiers. All results are computed offline with no external API call required.","failureModes":["Number string fails pattern validation (not 3-40 chars of digits/symbols) — returns 400 validation error","Ambiguous number with no +prefix and no default_region provided — may return invalid or misclassified result","Unknown or fictional number — returns valid:false or possible:false with no carrier/location data","Malformed input (wrong type, too short) — returns 422 or schema error"],"whenToPreferThis":"Choose this endpoint when you need instant, offline phone number validation with rich metadata (type, carrier, time zone) rather than just format checking. It is ideal for CRM enrichment, KYC pipelines, outreach scheduling, and calling agents where you need to know whether a number is reachable and what type it is. It does not send an OTP or call the number — it does not verify the number is currently active, only that it is structurally valid and possibly reachable.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-31T18:30:13.170Z","isFirstParty":false,"canonicalSlug":"phone-number-check-8a5d6413"}