Bulk Phone Number Validator and Formatter: E.164 (Offline)
Pricing
Pay per event
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
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
14 days ago
Last modified
Categories
Features
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 installmkdir -p storage/key_value_stores/default && cp test-input.json storage/key_value_stores/default/INPUT.jsonnpm start
About
Built and maintained by Small Gears Co (https://smallgearsco.com). Questions or feature requests: contact@smallgearsco.com