Skip to main content
GET
/
api
/
v1
/
wavalidation
/
batch
/
{batch_id}
curl "https://lookup.proweblook.com/api/v1/wavalidation/batch/550e8400-e29b-41d4-a716-446655440000?api_key=YOUR_API_KEY"

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "total_numbers": 4,
  "completed": 2,
  "failed": 0,
  "pending": 2,
  "results": [
    {
      "phone_number": "+14155552671",
      "status": "completed",
      "wa_status": "VALID_CONFIRMED",
      "numberstatus": true,
      "businessnumber": false,
      "formatted_number": "+14155552671",
      "carrier": "T-Mobile",
      "country": "US"
    },
    {
      "phone_number": "+919876543210",
      "status": "pending"
    }
  ]
}

​
Overview

After submitting a batch, use this endpoint to check its progress and retrieve results. Poll periodically until the top-level status changes to completed.

​
Path Parameters

​
batch_id
string
required
The UUID returned from the Submit Batch endpoint.

​
Query Parameters

​
api_key
string
required
Your ProWebLook API key. Must match the key used to submit the batch.

​
Response

​
batch_id
string
The batch UUID.
​
status
string
Overall batch status:
  • processing — Still running. Keep polling.
  • completed — All numbers have been processed. Stop polling.
​
total_numbers
integer
Total number of phone numbers in the batch.
​
completed
integer
Number of phone numbers that have finished processing (success or failure).
​
failed
integer
Number of phone numbers that encountered an error during processing.
​
pending
integer
Number of phone numbers still awaiting processing. Calculated as total_numbers - completed - failed.
​
results
array
Array of result objects, one per phone number.

​
Polling Best Practices

Poll every 5–10 seconds for small batches (<100 numbers) and every 30–60 seconds for large batches (1,000 numbers). Avoid polling more frequently than every 2 seconds.
JavaScript polling loop
async function pollBatchUntilDone(batchId, apiKey) {
  const url = `https://lookup.proweblook.com/api/v1/wavalidation/batch/${batchId}?api_key=${apiKey}`;

  while (true) {
    const response = await fetch(url);
    const data = await response.json();

    console.log(`Status: ${data.status} | Completed: ${data.completed}/${data.total_numbers}`);

    if (data.status === "completed") {
      console.log("Batch done!", data.results);
      return data.results;
    }

    // Wait 10 seconds before polling again
    await new Promise(resolve => setTimeout(resolve, 10000));
  }
}

curl "https://lookup.proweblook.com/api/v1/wavalidation/batch/550e8400-e29b-41d4-a716-446655440000?api_key=YOUR_API_KEY"

{
  "batch_id": "550e8400-e29b-41d4-a716-446655440000",
  "status": "processing",
  "total_numbers": 4,
  "completed": 2,
  "failed": 0,
  "pending": 2,
  "results": [
    {
      "phone_number": "+14155552671",
      "status": "completed",
      "wa_status": "VALID_CONFIRMED",
      "numberstatus": true,
      "businessnumber": false,
      "formatted_number": "+14155552671",
      "carrier": "T-Mobile",
      "country": "US"
    },
    {
      "phone_number": "+919876543210",
      "status": "pending"
    }
  ]
}