Bulk Phone Number Validator & Formatter (E.164, Offline)
Pricing
from $0.50 / 1,000 number validateds
Bulk Phone Number Validator & Formatter (E.164, Offline)
Validate and format phone numbers in bulk, 100% offline with Google's libphonenumber: valid or not, E.164, international, national and RFC 3966 formats, country, calling code, number type and extension. Handles messy input. $0.50 per 1,000 numbers. By Steadyline Data.
Pricing
from $0.50 / 1,000 number validateds
Rating
0.0
(0)
Developer
Steadyline Data
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
a day ago
Last modified
Categories
Features
Share
Validate and format phone numbers in bulk, 100% offline, with Google's libphonenumber (max metadata). Give it a messy CRM or lead list; get a clean row per number:
- Valid / possible flags (
isValid,isPossible) for every country and region libphonenumber covers. - E.164, international, national and RFC 3966 (
tel:) formats, plus country calling code, ISO country, national number, number type and extension. - Messy input is fine: spaces, parentheses, dashes, leading
00or011,tel:URIs, vanity letters (1-800-FLOWERS) and extensions (ext. 12,x12,;ext=12). - No scraping, no live carrier lookup, no paid API. Nothing leaves the Actor.
Use cases
- CRM and lead-list cleanup: normalize phones from website contact scrapes, imports and CSVs to E.164 before you dedupe or dial.
- Lead enrichment pipelines: run this after Website Contact Extractor to validate and format every phone it found.
- Outbound and SMS hygiene: drop invalid numbers before you pay a dialer, WhatsApp checker or carrier lookup.
- AI agents and MCP: an agent can hand this Actor a list of numbers and get structured E.164 plus line type back, with no extra prompting.
- International data entry: national numbers from the US, UK, Germany, India and 200+ other countries, as long as you set the default country (or pass
+/00international form).
Input
{"phoneNumbers": ["+1 650 253 0000","(650) 253-0000","+44 20 7183 8750","+49 30 39405430","+91 98765 43210","1-800-FLOWERS","+1 650 253 0000 ext. 12","00442071838750","not-a-number"],"defaultCountry": "US","dedupe": true}
defaultCountry is an ISO 3166-1 alpha-2 code (US, GB, DE, IN, …). It is used only when a number is not already in international form (+ or 00/011). Numbers from several countries can be mixed in one run if they are in international form.
Output sample
{"input": "+1 650 253 0000 ext. 12","isValid": true,"isPossible": true,"countryCallingCode": "1","country": "US","nationalNumber": "6502530000","e164": "+16502530000","international": "+1 650 253 0000 ext. 12","national": "(650) 253-0000 ext. 12","rfc3966": "tel:+16502530000;ext=12","type": "fixed-line-or-mobile","extension": "12","error": null,"charged": true}
The dataset has two views: Overview and Formats.
type is one of: mobile, fixed-line, fixed-line-or-mobile, voip, toll-free, premium-rate, shared-cost, personal-number, pager, uan, voicemail, or null when unknown.
error is set when isValid is false: empty, not-a-number, missing-country, too-short, too-long, invalid-country, or invalid (possible length but not a valid number, e.g. a reserved range).
Pricing (pay per event)
| Event | Price | When |
|---|---|---|
number-validated | $0.0005 per number | A unique phone number was analyzed, whether it is valid or not. |
apify-actor-start | $0.00005 per GB-run (min 1) | The Actor starts. Default memory is 256 MB, so this is usually one event. |
Empty inputs and duplicates are never charged. When Skip duplicates is on (the default), later copies are dropped. When it is off, later copies still appear in the dataset with charged: false and duplicate: true.
Cost example: 10,000 unique numbers costs $5.00 in events, plus a fraction of a cent to start the run.
Use it from AI agents (MCP), Zapier, Make, n8n or the API
AI agents (Claude, Cursor, VS Code, ChatGPT and other MCP clients). Add Apify's hosted MCP server with just this Actor as a tool:
{"mcpServers": {"apify": {"url": "https://mcp.apify.com?tools=steadyline/phone-number-validator"}}}
Sign in with Apify (OAuth) on first connect, or add an Authorization: Bearer <APIFY_TOKEN> header. Then ask your agent, for example:
Use steadyline/phone-number-validator to validate and format this list of phone numbers to E.164, drop invalid ones, and keep extensions.
The agent sees this Actor's input schema and output fields, so it can call it without extra prompting. Agents that use the general Apify MCP server can also find it with search-actors.
This Actor uses pay-per-event pricing with limited permissions, so it can also be run through Apify's agentic payments (no Apify account needed for the agent). See the Apify docs.
Zapier, Make and n8n. Use the official Apify app: Zapier "Run Actor" action, Make "Run an Actor" module, or the n8n Apify node. Choose steadyline/phone-number-validator, paste the input below, then use "Get dataset items" (or the run's dataset) to send results to Google Sheets, Slack, a CRM or a database.
API (any language). Run it and get the results in one call:
curl -X POST "https://api.apify.com/v2/acts/steadyline~phone-number-validator/run-sync-get-dataset-items?token=$APIFY_TOKEN" \-H "Content-Type: application/json" \-d '{"phoneNumbers":["+1 650 253 0000","(650) 253-0000","+44 20 7183 8750","+49 30 39405430","+91 98765 43210","1-800-FLOWERS","+1 650 253 0000 ext. 12","not-a-number"],"defaultCountry":"US"}'
Or with the Python client (pip install apify-client):
from apify_client import ApifyClientclient = ApifyClient("<APIFY_TOKEN>")run = client.actor("steadyline/phone-number-validator").call(run_input={"phoneNumbers": ["+1 650 253 0000", "(650) 253-0000", "+44 20 7183 8750", "+49 30 39405430", "+91 98765 43210", "1-800-FLOWERS", "+1 650 253 0000 ext. 12", "not-a-number"], "defaultCountry": "US"})for item in client.dataset(run["defaultDatasetId"]).iterate_items():print(item)
Works well with other Steadyline Data tools
- Contact then clean: Website Contact Extractor finds public phones and emails on company sites; this Actor formats the phones to E.164; Bulk Email Validator cleans the emails (MX, disposable, typo check, no SMTP).
- Lead list QA: after a scrape or import, run this Actor on the phone column and the email validator on the email column in parallel.
- Related: Website Contact Scraper, Bulk Email Validator: MX, Disposable & Typo Check (No SMTP), Company Team Page Scraper.
FAQ
Does this tell me if a number is in service, or who owns it?
No. It is an offline format and validity check, not a live carrier, HLR, TCPA or reverse-lookup API. isValid means the number is a real number plan for that country (right length and prefix), not that it is currently assigned or reachable.
Which library does it use? libphonenumber-js with the max metadata build, a JavaScript port of Google's libphonenumber. Geocoding, carrier name and timezone metadata are not included (those data files are large); you get validation, type and formatting only.
Do I need a default country?
Only for national numbers such as (650) 253-0000 or 020 7183 8750. International numbers starting with +, 00 or 011 are parsed without it. If a national number is given with no default country, the row comes back as missing-country and is still charged (it was analyzed).
How are extensions and vanity numbers handled?
Extensions in ext., extension, x, # and ;ext= forms are returned in extension and in the RFC 3966 URI. Letter-based vanity numbers such as 1-800-FLOWERS are converted with the standard keypad mapping, then validated.
Which numbers are charged?
Each unique number analyzed is $0.0005, including invalid ones (knowing a number is invalid is the point). Empty rows and duplicates are free (charged: false).
Can I run it on a schedule? Yes. Create an Apify Schedule (or a saved Task with a schedule) and connect a webhook or integration to receive results.
Need a feature or found a bug? Open an issue on the Issues tab of this page or email steadylinedata@proton.me. Built and maintained by Steadyline Data.
Acceptable use
Use this Actor only on numbers you are legally allowed to process: for example your own customers, sign-ups or CRM contacts, under a legitimate interest or consent. It does not look up owners or scrape directories. Don't use it to build or validate lists for unsolicited calls or SMS. You're responsible for complying with GDPR, TCPA, ICO, CASL and similar laws.
Built and maintained by Steadyline Data. Validation uses libphonenumber-js (MIT), a port of Google's libphonenumber.