Bulk Phone Number Validator and Formatter: E.164 (Offline) avatar

Bulk Phone Number Validator and Formatter: E.164 (Offline)

Pricing

Pay per event

Go to Apify Store
Bulk Phone Number Validator and Formatter: E.164 (Offline)

Bulk Phone Number Validator and Formatter: E.164 (Offline)

Bulk phone number validator and formatter: E.164, country and line type for $1 per 1,000 numbers. Offline libphonenumber, no live carrier lookup.

Pricing

Pay per event

Rating

0.0

(0)

Developer

Small Gears Co

Small Gears Co

Maintained by Community

Actor stats

0

Bookmarked

2

Total users

1

Monthly active users

14 days ago

Last modified

Features

Limited permissions

Share

Phone Number Validator and Formatter: E.164, Country, Line Type (Offline libphonenumber)

Validate, normalize and classify phone numbers in bulk: E.164, national and international formats, country, calling code and line type (such as mobile or fixed line). Runs offline with libphonenumber, so it is fast, cheap and needs no API key. For CRM cleanup, lead enrichment, form validation and agents that need clean phone numbers.

What it does

  • Parses numbers in any common format, with or without a + country code.
  • Uses defaultCountry (two-letter ISO code, default US) for numbers without a + prefix.
  • Reports whether each number is valid and possible, and its line type (or UNKNOWN).
  • Does not call any carrier or network service, so it cannot tell whether a number is currently active.

Input

See .actor/input_schema.json. Example:

{
"phones": [
"+1 650-253-0000",
"020 7946 0958",
"+44 7700 900123",
"abc"
],
"defaultCountry": "GB"
}

Output

One dataset item per input. Fields are flat JSON, ready for AI agents and spreadsheets. Sample from a real test run:

{
"input": "+1 650-253-0000",
"valid": true,
"possible": true,
"e164": "+16502530000",
"national": "(650) 253-0000",
"international": "+1 650 253 0000",
"country": "US",
"countryCallingCode": "1",
"lineType": "FIXED_LINE_OR_MOBILE"
}

Input that cannot be parsed returns { "input": "abc", "valid": false, "possible": false, "error": "Unparseable" }.

FAQ

Does it check if a number is live or who owns it? No. Validation is offline, based on libphonenumber numbering rules. There is no carrier (HLR) lookup or owner lookup.

Why is line type FIXED_LINE_OR_MOBILE? Some countries, including the US, do not distinguish mobile and fixed line numbers by number range, so libphonenumber cannot tell them apart.

Can an AI agent or MCP client use it? Yes. A list of strings in, flat JSON per number out, via the Apify API or an MCP client that runs Apify Actors.

How is it priced? Billing is set up per result (pay-per-event): one charge event per successful output row, and error rows are not charged. The price is $1 per 1,000 numbers. Unparseable rows are returned with an error field and are not charged.

Local test

npm install
mkdir -p storage/key_value_stores/default && cp test-input.json storage/key_value_stores/default/INPUT.json
npm start

About

Built and maintained by Small Gears Co (https://smallgearsco.com). Questions or feature requests: contact@smallgearsco.com