Phone Number Validator & Formatter (offline, private)
Pricing
$0.40 / 1,000 number validateds
Phone Number Validator & Formatter (offline, private)
Validates and normalizes phone numbers to E.164 using libphonenumber's numbering-plan data: possible/valid, region, number type, time zones and standard formats. Fully offline: no carrier, messaging-app or owner lookups, and no number leaves the run.
Pricing
$0.40 / 1,000 number validateds
Rating
0.0
(0)
Developer
Brenden Bushman
Maintained by CommunityActor stats
0
Bookmarked
2
Total users
1
Monthly active users
2 days ago
Last modified
Categories
Share
Validate and normalize phone numbers in bulk without sending them anywhere. The Actor uses the numbering-plan data of Google's libphonenumber to tell you whether each number is possible and valid, which country it belongs to, what kind of number it is, and how to write it in E.164, international and national format.
No carrier lookup, no messaging-app probe, no owner lookup: the numbers you submit never leave the run.
What you get
- E.164 normalization (
+442079460958) from any common input (020 7946 0958,(415) 555-0132,1-800-FLOWERS) - Possible vs valid: a number can have the right length but sit outside any assigned range; both are reported
- Region and country code (
GB,44), number type by plan range (MOBILE,FIXED_LINE,TOLL_FREE,VOIP,PREMIUM_RATE...), and the time zones the range is used in - A named reason for every failure:
too-short,too-long,invalid-country-code,not-a-number,not-in-numbering-plan
When to use it
- Cleaning CRM, sign-up or order data before import, deduplication or SMS sending
- Normalizing numbers collected in many countries and formats into one column
- Any workflow where sending customer numbers to a third-party lookup service is not acceptable
What it cannot tell you: whether a number is currently in service, who owns it, or which carrier it was ported to. Those need live network lookups, which this Actor deliberately does not do.
Input
| Field | Type | Default | Notes |
|---|---|---|---|
phoneNumbers | array of strings | (required) | Up to 200,000 per run. |
defaultRegion | string | US | ISO 3166 code for numbers written without +country. |
Output
{"input": "020 7946 0958", "isPossible": true, "isValid": true, "e164": "+442079460958","international": "+44 20 7946 0958", "national": "020 7946 0958", "regionCode": "GB", "countryCode": 44,"numberType": "FIXED_LINE", "timeZones": ["Europe/London"], "error": null}
Pricing
Pay per event, no start fee:
| Event | Price | Per 1,000 |
|---|---|---|
number-validated | $0.0004 | $0.40 |
Support
Report problems in the Issues tab. We aim to respond within a few days.