{"name":"phone-validator","id":"sfoln/phone-validator","title":"Phone Number Validator","description":"Validate and format phone numbers in bulk with Google's libphonenumber: valid or possible, E.164, international and national formats, country, calling code and number type (mobile, landline, VoIP). $0.80 per 1,000 numbers; non-numbers are free. Optional live carrier lookup.","version":"0.1","status":"ready","family":{"id":"company-lead-intelligence","name":"Company & lead intelligence","description":"Company enrichment, contact discovery, tech-stack detection, hiring signals, job listings, public tenders, Shopify stores, marketplace listings, NPI provider records, e-mail and phone validation.","actors":13},"categories":["LEAD_GENERATION","DEVELOPER_TOOLS","AUTOMATION"],"availability":"on_request","seoTitle":"Phone Number Validator API – $0.80 per 1,000 numbers","seoDescription":"Bulk phone number validator API: check validity, number type and country and format every number to E.164 with libphonenumber. $0.80 per 1,000 numbers.","summary":"Phone Number Validator validates, normalizes and classifies phone numbers in bulk. For each number you get valid / possible, the E.164, international and national formats, the country, the calling code and the number type (mobile, fixed line, toll-free, VoIP…). Validation runs offline on Google's libphonenumber metadata, so it is fast and cheap: ideal for cleaning CRM exports, sign-up forms and lead lists, and for AI agents that need a normalized number before calling or texting. An optional carrier lookup adds the carrier name and line type from a live carrier database.","pricing":{"model":"pay-per-event","currency":"USD","billedBy":"Apify","freePlanMaxItemsPerRun":10,"events":[{"name":"phone-validated","title":"Validated phone number","description":"Charged once per phone number that could be parsed and validated (valid or invalid verdict, formats, country, type).","priceUsd":0.0008},{"name":"phone-carrier-lookup","title":"Carrier lookup","description":"Charged once per valid number for which the optional live carrier lookup succeeded (carrier name, line type, region).","priceUsd":0.005}]},"input":{"description":"Paste phone numbers (one per line) in any common format. Each number produces one dataset record with validity, formats, country and number type.","required":["phones"],"fields":[{"name":"phones","title":"Phone numbers","type":"array","required":true,"description":"Phone numbers in international (+44 20 7946 0958) or national format (national numbers need a default country), one per line; commas and semicolons stay part of the number (e.g. ;ext=123). The same number written in different formats is processed once. Objects with a `phone` field are accepted too. Accounts on the Apify free plan can process up to 10 phone numbers per run.","prefill":["+1 650-253-0000","+44 20 7946 0958","030 901820"],"editor":"stringList"},{"name":"defaultCountry","title":"Default country","type":"string","required":false,"description":"ISO 3166-1 alpha-2 code (e.g. US, GB, DE) used for numbers written without a +country prefix.","prefill":"DE","editor":"textfield"},{"name":"carrierLookup","title":"Carrier lookup (extra charge)","type":"boolean","required":false,"description":"Also look up the carrier name, line type and region for each valid number via a live carrier database. Charged as a separate event per successful lookup. Paid add-on: turned off on the Apify free plan (records carry a warning).","default":false},{"name":"maxNumbers","title":"Max numbers","type":"integer","required":false,"description":"Safety cap on the number of phone numbers processed in this run.","default":10000,"minimum":1,"maximum":100000},{"name":"concurrency","title":"Concurrency","type":"integer","required":false,"description":"Parallel workers (matters only with carrier lookup).","default":10,"minimum":1,"maximum":10},{"name":"includeRaw","title":"Include raw upstream response","type":"boolean","required":false,"description":"Attach the raw carrier-lookup payload (only with carrier lookup).","default":false}]},"exampleInput":{"phones":["+1 650-253-0000","+44 20 7946 0958","030 901820"],"defaultCountry":"DE"},"outputFields":[{"name":"input","type":"string","title":"Input","description":"The phone number as submitted."},{"name":"isValid","type":"boolean","title":"Valid","description":"Number matches an assigned numbering range for its country."},{"name":"isPossible","type":"boolean","title":"Possible","description":"Length is plausible for the country (weaker than valid)."},{"name":"e164","type":"string","title":"E.164","example":"+442079460958"},{"name":"international","type":"string","title":"International format","example":"+44 20 7946 0958"},{"name":"national","type":"string","title":"National format","example":"020 7946 0958"},{"name":"rfc3966","type":"string","title":"tel: URI"},{"name":"countryCode","type":"string","title":"Calling code","example":"44"},{"name":"country","type":"string | null","title":"Country (ISO2)","example":"GB"},{"name":"nationalNumber","type":"string","title":"National number"},{"name":"extension","type":"string | null","title":"Extension"},{"name":"numberType","type":"string | null","title":"Number type","description":"MOBILE, FIXED_LINE, FIXED_LINE_OR_MOBILE, TOLL_FREE, PREMIUM_RATE, SHARED_COST, VOIP, PERSONAL_NUMBER, PAGER, UAN, VOICEMAIL or null."},{"name":"carrierHint","type":"null","title":"Carrier hint","description":"Always null: offline validation does not include the carrier. Use carrierLookup."},{"name":"carrier","type":"string | null","title":"Carrier","description":"Only with carrierLookup (paid plans); null when the lookup was skipped, failed or could not be charged."},{"name":"carrierLineType","type":"string | null","title":"Carrier line type","description":"Only with carrierLookup (paid plans); null when the lookup was skipped, failed or could not be charged."},{"name":"carrierRegion","type":"string | null","title":"Carrier region","description":"Only with carrierLookup (paid plans); null when the lookup was skipped, failed or could not be charged."},{"name":"carrierLookupCharged","type":"boolean","title":"Carrier lookup charged","description":"True when the phone-carrier-lookup event was charged for this number."},{"name":"status","type":"string","title":"Status","description":"ok | error | skipped_invalid | skipped_budget | skipped_free_plan","example":"ok"},{"name":"charged","type":"boolean","title":"Charged"},{"name":"source","type":"string","title":"Source"},{"name":"fetchedAt","type":"string","title":"Fetched at"}],"outputExample":{"input":"+44 20 7946 0958","isValid":true,"isPossible":true,"e164":"+442079460958","international":"+44 20 7946 0958","national":"020 7946 0958","rfc3966":"tel:+442079460958","countryCode":"44","country":"GB","nationalNumber":"2079460958","extension":null,"numberType":"FIXED_LINE","carrierHint":null,"status":"ok","charged":true,"chargedEvent":"phone-validated","source":"libphonenumber","fetchedAt":"2026-10-14T10:00:00.000Z"},"faq":[],"mcpExamplePrompt":"Validate these phone numbers and give me each one in E.164 format with its country and number type: +1 650-253-0000, +44 20 7946 0958 and the German number 030 901820.","related":["email-validator","company-contacts-finder","google-maps-business-leads"],"urls":{"site":"https://www.sfoln.com/actors/phone-validator/","siteJson":"https://www.sfoln.com/actors/phone-validator.json","siteMarkdown":"https://www.sfoln.com/actors/phone-validator.md","runSync":"https://api.apify.com/v2/actors/sfoln~phone-validator/run-sync-get-dataset-items","runAsync":"https://api.apify.com/v2/actors/sfoln~phone-validator/runs","mcp":"https://mcp.apify.com?tools=sfoln/phone-validator","requestAccess":"mailto:contact@sfoln.com?subject=Access%20request%3A%20Phone%20Number%20Validator%20(sfoln%2Fphone-validator)&body=Please%20publish%20phone-validator.%20What%20we%20plan%20to%20use%20it%20for%3A"},"publisher":{"name":"SFOLN LLC","apifyUsername":"sfoln","url":"https://www.sfoln.com","apifyProfile":"https://apify.com/sfoln","email":"contact@sfoln.com"},"generatedAt":"2026-10-22T04:28:58.477Z"}