Skip to main content
POST
/
api
/
v1
/
wavalidation
/
batch
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"
    ]
  }'

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440000",
  "total_numbers": 4,
  "status": "processing"
}

​
Overview

The Batch WhatsApp Validation API lets you submit large lists of phone numbers for WhatsApp status checking. Numbers are processed asynchronously via a queue. After submitting, use the Poll endpoint to retrieve results. Maximum batch size: 1,000 numbers per request.

​
How It Works

1

Submit Batch

POST your list of phone numbers to this endpoint. You’ll receive a batch_id immediately.
2

Processing

Each number is queued and validated asynchronously. Status begins as processing.
3

Poll for Results

Call the Poll endpoint with your batch_id repeatedly until status becomes completed.

​
Request Parameters

​
api_key
string
required
Your ProWebLook API key. See Authentication.
​
phone_numbers
array
required
A JSON array of phone number strings to validate. Duplicates are automatically removed.Maximum: 1,000 numbers per batch.
["phone_numbers": ["+14155552671", "+919876543210", "+441234567890"]

​
Response

​
batch_id
string
A unique UUID identifying this batch job. Store this to poll for results later.
​
total_numbers
integer
The number of unique phone numbers queued for processing.
​
status
string
Current batch status. Will be processing immediately after submission.

​
Credit Cost

1 WA credit is deducted per phone number. The required balance is checked upfront — if you have fewer credits than numbers in the batch, the entire batch is rejected.
If you submit 500 numbers, you need at least 500 WA credits available before submitting. Credits are deducted at submission time.
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"
    ]
  }'

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440000",
  "total_numbers": 4,
  "status": "processing"
}