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"
]
}'
const response = await fetch("https://lookup.proweblook.com/api/v1/wavalidation/batch", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
api_key: "YOUR_API_KEY",
phone_numbers: [
"+14155552671",
"+919876543210",
"+441234567890"
]
})
});
const { batch_id, total_numbers, status } = await response.json();
console.log("Batch submitted:", batch_id);
import requests
response = requests.post(
"https://lookup.proweblook.com/api/v1/wavalidation/batch",
json={
"api_key": "YOUR_API_KEY",
"phone_numbers": [
"+14155552671",
"+919876543210",
"+441234567890"
]
}
)
data = response.json()
batch_id = data["batch_id"]
print(f"Batch ID: {batch_id}")
{
"batch_id": "550e8400-e29b-41d4-a716-446655440000",
"total_numbers": 4,
"status": "processing"
}
{
"error": "Insufficient WA API credits.",
"required": 4,
"available": 2
}
{
"error": "Batch size exceeds the maximum allowed limit of 1000 numbers.",
"submitted": 1500,
"max_allowed": 1000
}
{
"error": "phone_numbers array is required and must not be empty."
}
API Reference
WA Batch Validation — Submit
Submit up to 1,000 phone numbers at once for asynchronous WhatsApp validation.
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"
]
}'
const response = await fetch("https://lookup.proweblook.com/api/v1/wavalidation/batch", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
api_key: "YOUR_API_KEY",
phone_numbers: [
"+14155552671",
"+919876543210",
"+441234567890"
]
})
});
const { batch_id, total_numbers, status } = await response.json();
console.log("Batch submitted:", batch_id);
import requests
response = requests.post(
"https://lookup.proweblook.com/api/v1/wavalidation/batch",
json={
"api_key": "YOUR_API_KEY",
"phone_numbers": [
"+14155552671",
"+919876543210",
"+441234567890"
]
}
)
data = response.json()
batch_id = data["batch_id"]
print(f"Batch ID: {batch_id}")
{
"batch_id": "550e8400-e29b-41d4-a716-446655440000",
"total_numbers": 4,
"status": "processing"
}
{
"error": "Insufficient WA API credits.",
"required": 4,
"available": 2
}
{
"error": "Batch size exceeds the maximum allowed limit of 1000 numbers.",
"submitted": 1500,
"max_allowed": 1000
}
{
"error": "phone_numbers array is required and must not be empty."
}
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
string
required
Your ProWebLook API key. See Authentication.
string[]
required
A JSON array of phone number strings to validate. Duplicates are automatically removed.Maximum: 1,000 numbers per batch.
Using the Playground?
Click ”+ Add string” below to enter a phone number. To add another number, click ”+ Add string” again. Enter each number in its own text box.
"phone_numbers": ["+14155552671", "+919876543210", "+441234567890"]
Response
string
A unique UUID identifying this batch job. Store this to poll for results later.
integer
The number of unique phone numbers queued for processing.
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"
]
}'
const response = await fetch("https://lookup.proweblook.com/api/v1/wavalidation/batch", {
method: "POST",
headers: { "Content-Type": "application/json" },
body: JSON.stringify({
api_key: "YOUR_API_KEY",
phone_numbers: [
"+14155552671",
"+919876543210",
"+441234567890"
]
})
});
const { batch_id, total_numbers, status } = await response.json();
console.log("Batch submitted:", batch_id);
import requests
response = requests.post(
"https://lookup.proweblook.com/api/v1/wavalidation/batch",
json={
"api_key": "YOUR_API_KEY",
"phone_numbers": [
"+14155552671",
"+919876543210",
"+441234567890"
]
}
)
data = response.json()
batch_id = data["batch_id"]
print(f"Batch ID: {batch_id}")
{
"batch_id": "550e8400-e29b-41d4-a716-446655440000",
"total_numbers": 4,
"status": "processing"
}
{
"error": "Insufficient WA API credits.",
"required": 4,
"available": 2
}
{
"error": "Batch size exceeds the maximum allowed limit of 1000 numbers.",
"submitted": 1500,
"max_allowed": 1000
}
{
"error": "phone_numbers array is required and must not be empty."
}