WhatsApp Number Validator — Live Registration Check

Validate phone numbers you are authorized to process against a configured WhatsApp provider. The Actor normalizes E.164 input, deduplicates it, returns one structured live registration result per completed number, and records actionable batch diagnostics.

Use it for

• Consent-based CRM hygiene and customer-contact verification.
• Verifying numbers your organization is authorized to validate before a support workflow.
• Agent workflows that need a compact, machine-readable registration result.

Do not use it to enumerate people, collect profiles, discover contacts, or conduct unsolicited outreach. The Actor never sends a WhatsApp message and does not request profile data.

Setup

An owner must configure an authorized WHAPI_API_KEY environment secret before live checks can run. It is intentionally not accepted as ordinary Actor input, logged, returned, or included in diagnostics. The provider may require a linked WhatsApp channel and has its own account, rate-limit, and acceptable-use requirements.

Input

{
  "phoneNumbers": ["+14155550123", "+442071838750"],
  "maxConcurrency": 2,
  "batchSize": 25,
  "consentConfirmed": true
}

Use full E.164 numbers. Local numbers are deliberately rejected rather than guessed from a country setting, preventing incorrect validation against another person’s number.

Output

{
  "inputNumber": "+14155550123",
  "normalizedNumber": "+14155550123",
  "isRegisteredOnWhatsApp": true,
  "providerStatus": "valid",
  "checkedAt": "2026-07-21T12:00:00.000Z",
  "warnings": []
}

isRegisteredOnWhatsApp is a live provider result, not a format-only “WhatsApp-ready” heuristic. Each run also writes OUTPUT and RUN_SUMMARY, using COMPLETE, PARTIAL, VALID_EMPTY, INVALID_INPUT, UPSTREAM_FAILED, or CONFIG_ERROR outcomes.

Pricing

The Actor uses Pay per Event plus platform-usage pass-through:

Event	Price
Actor start	$0.00005
Live WhatsApp number validation	$0.006 per persisted result

Only a successfully persisted provider-backed record is charged. Invalid input and failed provider requests are not charged. Your provider may charge separately under its own plan.

API example

curl -X POST "https://api.apify.com/v2/acts/khadinakbar~whatsapp-number-validator/run-sync-get-dataset-items?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"phoneNumbers":["+14155550123"],"consentConfirmed":true}'

Related workflow

Use Phone Number Lookup API when you need format, carrier, or fraud signals rather than a live WhatsApp registration result.