⚡ Fast WhatsApp Number Validator — Bulk Phone Check & List Cleanup

Clean and validate any phone list before you launch a WhatsApp or SMS campaign — thousands of numbers in seconds. Paste numbers in bulk and get back, for each one: whether it's a valid number, its E.164 format, country, region, carrier, line type (mobile / landline / VoIP), time zones, and a WhatsApp-ready flag — so you stop wasting sends on landlines, typos and dead numbers.

✅ 100% offline — no login, no QR scan, no proxy, no API keys, no bans. Built on Google's libphonenumber, the same engine carriers use. It can't be blocked and it won't silently break.

Also known as: phone number validator, phone list cleaner, WhatsApp number checker, bulk phone verifier, mobile vs landline checker.

✅ New — optional live WhatsApp check. Turn on checkWhatsapp to actually verify whether each valid, mobile-capable number is registered on WhatsApp right now — you get whatsappRegistered (true/false) and, when the account is public, a whatsappProfilePic URL. It's a best-effort layer on top of the instant offline validation: if the live source is briefly unavailable you still get the full offline result (never a failed run). Off by default, so the Actor stays 100% offline and instant unless you ask for it.

---

🤖 For AI agents — MCP & Standby (validate on demand)

Run this Actor in Standby mode for a warm HTTP + MCP endpoint that validates a single number per call — the perfect step inside an agent or automation flow (clean a lead before you message it). Fully offline, so it answers instantly.

• MCP tool: validate_number → validity, E.164/international/national formats, country, region, carrier, line type and a whatsappCapability grade (yes/maybe/no).
• REST (same endpoint): GET /?number=+14155552671 (optional &defaultCountry=US)

Turn on Standby in the Actor's settings to get your endpoint URL.

---

⚡ Quick start

{
  "phoneNumbers": ["+14155552671", "+442071838750", "+5511991234567"],
  "defaultCountry": "US"
}

Each number comes back as one clean record.

---

🎯 Why this matters

WhatsApp and SMS only work on valid mobile numbers. A raw list is full of landlines, mistypes, wrong country codes and dead entries. Sending to those:

• wastes your WhatsApp Business message allowance and sender reputation,
• inflates costs on per-message platforms,
• and can get your number flagged for high failure rates.

Run your list through this first, drop everything that isn't a valid mobile, and only then spend on outreach.

---

📦 What you get per number

Field	Description
valid	Is it a real, dialable number
e164	Normalised +<country><number> (the format every API wants)
international / national	Human-readable formats
country / regionCode	e.g. United States / US
location	City / area description when available
carrier	Mobile carrier name when known (Claro, Airtel, JT …)
lineType	mobile, landline, fixed-or-mobile, voip, toll-free …
timezones	Time zones for the number (great for send-time targeting)
whatsappCapability	yes = confirmed mobile, maybe = mobile-or-landline plan (e.g. US/Canada — can't tell offline), no = landline / VoIP / invalid
whatsappCapable	true when the line can hold a WhatsApp account — a confirmed mobile or a mobile-capable plan (yes + maybe). false only for landline / VoIP / toll-free / invalid

---

⚙️ Input parameters

Field	Type	Default	Description
phoneNumbers	array	—	Numbers to validate (one per line)
numbersText	string	—	Optional: paste a whole list / spreadsheet column at once (merged & de-duplicated)
defaultCountry	string	US	ISO region for numbers without a leading +
onlyValid	bool	false	Return only valid numbers (clean list)
onlyWhatsappCapable	bool	false	Keep only WhatsApp-capable lines (yes + maybe); drop landline/VoIP/invalid
exportFormat	enum	default	default / csv / both

---

📤 Output example

{
  "input": "+5511991234567",
  "valid": true,
  "e164": "+5511991234567",
  "international": "+55 11 99123-4567",
  "country": "Brazil",
  "regionCode": "BR",
  "carrier": "Claro",
  "lineType": "mobile",
  "timezones": ["America/Sao_Paulo"],
  "whatsappCapability": "yes",
  "whatsappCapable": true
}

Set "exportFormat": "csv" for HubSpot / Excel-friendly columns.

---

💡 Use cases

• Pre-campaign list cleaning — drop landlines, typos and invalid numbers before a WhatsApp/SMS blast.
• Cut messaging costs — only keep numbers that can actually receive messages.
• CRM hygiene — normalise every number to E.164 and tag carrier / country.
• Lead enrichment — append country, region, carrier and line type to a contact list.
• Send-time targeting — use the time zone to message at the right local hour.

---

💰 Pricing

$1.5 / 1,000 results ($0.0015 per number). You pay per number returned — use onlyValid / onlyWhatsappCapable to return (and pay for) just the numbers you care about.

---

❓ FAQ

Does whatsappCapable mean the number is on WhatsApp? No. There is no public WhatsApp registration API, and bulk-checking through an unofficial logged-in session gets accounts banned — so this Actor stays 100% reliable by validating offline. whatsappCapable is true when the line can hold a WhatsApp account: a confirmed mobile, or a mobile-capable numbering plan that can't be split offline (see below). It is false only for landline, VoIP, toll-free and invalid numbers — the entries that can never receive a WhatsApp message. Use it to drop the junk before you spend on outreach.

Why are my US numbers maybe? US/Canada share one numbering plan for mobile and landline, so an offline check genuinely cannot tell them apart — every US number is graded whatsappCapability: "maybe" (still whatsappCapable: true, since it can be mobile). Treat maybe as "very likely reachable, not guaranteed"; only a live check confirms actual registration.

Which countries are supported? Global — libphonenumber covers every country's numbering rules.

---

⚖️ Use responsibly

This tool validates and formats phone numbers. You are responsible for having a lawful basis and any required consent before contacting people, and for complying with WhatsApp's terms, the TCPA, GDPR and other applicable laws.