Phone Number Validator & Formatter (Offline, Bulk)

Clean up a phone list in one run. Paste numbers in any format and get back the E.164, international and national formats, whether each number is valid for its country, its line type (mobile, landline, VoIP, toll-free, premium), its country, the approximate area, and its time zones.

It uses Google's open-source libphonenumber metadata and runs fully offline inside the Actor. Numbers aren't sent to any third-party API, and nobody gets called or texted.

What you can use it for

• Normalize CRM / checkout / signup data to E.164 before importing it into Twilio, HubSpot, Salesforce or a database
• Catch typos and fake numbers ("12345", missing digits) at the form or import stage
• Route by country, or schedule calls inside the right time zone
• Split mobile from landline numbers for SMS-capable lists you already have consent for

Input

Field	Default	Notes
phoneNumbers	—	Up to 100,000 strings in any format
defaultCountry	US	Used for numbers without a +country prefix
includeCarrier	true	The carrier the range was originally assigned to (number porting means this is a hint, not live HLR)
includeGeo	true	Area description + IANA time zones
deduplicate	true	Each distinct string is processed and charged once

Output (one row per number)

{
  "input": "020 7946 0958", "isValid": true, "isPossible": true,
  "e164": "+442079460958", "international": "+44 20 7946 0958", "national": "020 7946 0958",
  "countryCallingCode": 44, "regionCode": "GB", "lineType": "FIXED_LINE",
  "carrier": null, "location": "London", "timeZones": ["Europe/London"], "error": null
}

error is one of EMPTY, TOO_LONG, NOT_A_NUMBER, INVALID_COUNTRY_CODE, TOO_SHORT_NSN, NOT_POSSIBLE or INVALID_NUMBER.

Pricing (pay per event)

• $0.50 per 1,000 numbers (phone-validated, $0.0005 each), plus Apify's standard $0.00005 actor start.
• Duplicates are skipped and not charged. If you set a maximum cost for the run, the Actor stops when it's reached.

Limits and honesty

• "Valid" means the number matches the official numbering plan for that country. It does not mean the line is currently active, and no live network lookup (HLR) is done.
• Carrier data is the original allocation, so ported numbers can show their old carrier.

Responsible use

Only process numbers you're allowed to process (your customers, your leads, with consent). Don't use this for unsolicited calling or texting. Output stays in your own Apify dataset.

---

Actively maintained. Issues and feature requests are answered within 24 hours on the Issues tab.