Validate whether phone numbers have active WhatsApp accounts. Submit a list of phone numbers and get back per-number results showing WhatsApp status, WhatsApp ID, and normalized E.164 format.

Requires a Whapi.Cloud API key (free tier available).

Prerequisites

1. Sign up at whapi.cloud
2. Create a channel (connect a WhatsApp number)
3. Copy your API key from the channel settings
4. Paste it into the whapiApiKey input field when running this actor

Quick Start

{
    "phoneNumbers": ["+15550100", "+442079460000", "5550199"],
    "defaultCountryCode": "US",
    "whapiApiKey": "YOUR_WHAPI_CLOUD_API_KEY"
}

Phone numbers in this example use ITU-reserved fictional ranges (+1-555-01XX / +44-20-7946-0XXX). Replace with real numbers when running.

Input

Field	Type	Required	Description
phoneNumbers	string[]	Yes	Phone numbers in any format (auto-normalized to E.164)
defaultCountryCode	string	No	ISO 3166-1 alpha-2 code (US, GB, IN, etc.) for numbers without country code
whapiApiKey	string	Yes	Your Whapi.Cloud API key
dryRun	boolean	No	Normalize numbers only, skip WhatsApp check (default: false)

Output

Each number produces one result object in the dataset:

{
    "phoneNumber": "+15550100",
    "normalized": "+15550100",
    "hasWhatsApp": true,
    "whatsAppId": "14155552671",
    "status": "success",
    "error": null
}

Field	Type	Description
phoneNumber	string	Original input number
normalized	string	E.164 normalized format
hasWhatsApp	boolean/null	true if active, false if not, null if unknown or dry run
whatsAppId	string/null	WhatsApp ID if registered
status	string	success or error
error	string/null	Error message if status is error

Pricing

$0.003 per number checked. Dry-run mode is free (normalization only).

Phone Number Formats

The actor handles various input formats:

• International with +: +15550100
• International with 00: 004915512345678
• Local with default country: 9876543210 + defaultCountryCode: "IN" -> +919876543210
• With spaces/dashes/parens: (415) 555-2671

Rate Limiting

Requests are rate-limited to 2 per second to stay within Whapi.Cloud API limits.

Limitations

• Requires an active Whapi.Cloud account with a connected WhatsApp number
• Rate limited to 2 checks/second (batch of 1,000 numbers takes ~8 minutes)
• Accuracy depends on WhatsApp's contact lookup (some numbers may show as unregistered if recently changed)
• The connected WhatsApp number must not be banned or restricted

Related Tools

• Broken Link Checker — Crawl websites and find broken links
• LinkedIn Profile Scraper — Extract public LinkedIn profile data
• Email Validator — Validate email addresses in bulk

Tue Apr 14 22:51:14 IST 2026