WhatsApp number validator for developers

WhatsApp Number Validator API — Bulk Validate 1,000 Numbers per Batch

ProWebLook's WhatsApp number validator API processes up to 1,000 phone numbers per batch. Submit once, receive a batch_id instantly, then poll for WhatsApp registration status, Business account detection, carrier, country, and per-number results.

1,000Numbers per batch
202Accepted response
1:1WA credit per number
batch-response.json processing
{
  "batch_id": "550e8400-e29b...",
  "total_numbers": 1000,
  "status": "processing",
  "next": "poll_results"
}
872completed
116pending
12failed
Async batch workflow

Async WhatsApp Number Validator for High-Volume Contact Lists

ProWebLook's WhatsApp number validator API separates submission from results so CRM cleanup jobs, lead enrichment pipelines, and phone number validation workflows run without blocking your application.

1

Submit the batch

POST a JSON array of phone numbers with your API key. Duplicates are removed automatically and the maximum request size is 1,000 numbers.

2

Queue processing

The API returns a unique batch ID immediately. Each number is validated asynchronously and starts in processing or pending state.

3

Poll for results

Call the poll endpoint with the same API key until the top-level status becomes completed, then export or sync the finished results.

What you get

Bulk results that are ready for your CRM

Use structured result fields to segment WhatsApp-ready numbers, detect business accounts, retry temporary provider failures, and keep malformed records out of your campaigns.

WhatsApp status

Identify numbers that are registered on WhatsApp and separate contacts that cannot receive WhatsApp messages.

Business detection

Spot WhatsApp Business accounts with the businessnumber field for lead scoring and account enrichment.

Carrier and country

Use formatted numbers, carrier, and country values to normalize records before import or outreach.

Retry-friendly states

Completed, failed, and pending counts make it easy to retry only the rows that need another attempt.

API examples

Submit once, poll until completed

The submit endpoint checks your WA credit balance upfront. If you submit 500 numbers, you need at least 500 WA credits available before the batch is accepted.

0Unique numbers
0WA credits needed
5-10sSuggested polling
Paste a list to estimate your batch size. Maximum: 1,000 numbers per request.
curl -X POST "https://lookup.proweblook.com/api/v1/wavalidation/batch" \
  -H "Content-Type: application/json" \
  -d '{
    "api_key": "YOUR_API_KEY",
    "phone_numbers": [
      "+14155552671",
      "+919876543210",
      "+441234567890",
      "+33123456789"
    ]
  }'
EndpointMethodPurposeKey fields
/api/v1/wavalidation/batch POST Submit up to 1,000 phone numbers for asynchronous validation. api_key, phone_numbers, batch_id, total_numbers, status
/api/v1/wavalidation/batch/{batch_id} GET Poll status and retrieve completed, failed, pending, and per-number results. numberstatus, businessnumber, formatted_number, carrier, country
Use cases

Where bulk WhatsApp validation helps

Clean the list before sending, routing, uploading, or enriching contacts. That means fewer wasted credits in downstream tools and cleaner CRM data.

CRM data cleaning

Validate old lead lists and remove contacts that are not reachable on WhatsApp before assigning them to sales teams.

Campaign preparation

Segment WhatsApp-ready audiences before campaign upload so your outreach list starts with better deliverability.

Fraud and signup checks

Check batches of submitted phone numbers to spot low-quality signups or contacts that need additional review.

Data enrichment pipelines

Add WhatsApp presence, business account, carrier, and country signals to your existing data warehouse workflows.

Quick reference

WhatsApp bulk validator — API specifications

ProWebLook's WhatsApp number validator is a REST API that accepts a JSON array of up to 1,000 phone numbers and validates each asynchronously. Built for developers and data teams running phone number validation at scale.

  • No message or OTP sent to target numbers
  • Returns WhatsApp status, business flag, carrier and country per number
  • 1 WA credit per number — balance checked at submission
  • Works with any E.164 phone number across 180+ countries
Submit endpointPOST /api/v1/wavalidation/batch
Poll endpointGET /api/v1/wavalidation/batch/{batch_id}
Max batch size1,000 phone numbers per request
Credit cost1 WA credit per number, deducted upfront
Phone formatE.164 international format (+14155552671)
Duplicate handlingAutomatic removal before processing
Submit responseHTTP 202 Accepted + batch_id immediately
Result fieldsnumberstatus, businessnumber, formatted_number, carrier, country
Countries supported180+
Recommended polling5–10s (≤100 numbers) · 30–60s (≤1,000 numbers)
Auth methodAPI key (api_key parameter)
FAQ

Frequently asked questions about bulk WhatsApp number validation

You can submit up to 1,000 phone numbers per request. Duplicate numbers are automatically removed before processing.
The submit endpoint returns a batch_id. Use the poll endpoint with that batch_id and the same API key until the top-level status becomes completed.
The API deducts 1 WA credit per submitted phone number. Your balance is checked upfront, so a 500-number batch requires at least 500 WA credits before submission.
Poll every 5-10 seconds for small batches under 100 numbers and every 30-60 seconds for large batches. Avoid polling more often than every 2 seconds.
Use the single checker for one-off lookups and the bulk WhatsApp validation API for CRM lists, imports, marketing databases, and other high-volume workflows.
Yes. Every per-number result includes a businessnumber field that is true when the phone number is registered as a WhatsApp Business account. Use this field for lead scoring, account-based outreach segmentation, and separating personal contacts from business contacts in your CRM.

Start validating WhatsApp numbers in bulk

Create a ProWebLook account, get your API key, and submit your first batch. Free credits are available for testing before you scale.

Start Free
Free Credits Included

Get FREE Credits to Start Today

Discover an extensive array of API calls across all ProWebLook APIs. No credit card required — start building in minutes.