Bulk Phone Number Validator & Formatter (E.164, Offline) avatar

Bulk Phone Number Validator & Formatter (E.164, Offline)

Pricing

from $0.50 / 1,000 number validateds

Go to Apify Store
Bulk Phone Number Validator & Formatter (E.164, Offline)

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

Steadyline Data

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

a day ago

Last modified

Features

Limited permissions

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 00 or 011, 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 + / 00 international 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)

EventPriceWhen
number-validated$0.0005 per numberA 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 ApifyClient
client = 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

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.