WhatsApp Number Verification Status API
End Point: https://wbiztool.com/api/v1/verification/status/
Request Type: GET
Required Parameters
-
api_key (String)
- Your API Key (Given on API Keys page) (Can be sent in Authorization header as Bearer token) -
campaign_id (Integer)
- The campaign ID returned from the verification create API
Fields in Response
-
status (String)
- "success" if request processed successfully -
campaign_id (Integer)
- ID of the verification campaign -
campaign_name (String)
- Name of the verification campaign -
overall_status (String)
- Overall status: "pending", "processing", or "completed" -
progress (Object)
- Progress information with total, pending, verified, invalid counts and completion percentage -
results (Array)
- Array of verification results with number, status, and timestamps -
created_at (String)
- Campaign creation timestamp -
last_updated (String)
- Last update timestamp
Example
The following example shows how to check the status of a verification campaign.
curl -X GET "https://wbiztool.com/api/v1/verification/status/?campaign_id=123" \
-H "Authorization: Bearer your_api_key"
// Response
{
"status": "success",
"campaign_id": 123,
"campaign_name": "Customer Numbers Verification",
"overall_status": "processing",
"progress": {
"total": 3,
"pending": 1,
"verified": 2,
"invalid": 0,
"completed_percentage": 66.67
},
"results": [
{
"number": "919876543210",
"status": "verified",
"checked_at": "2024-01-15T10:30:00Z",
"created_at": "2024-01-15T10:00:00Z"
},
{
"number": "911234567890",
"status": "verified",
"checked_at": "2024-01-15T10:31:00Z",
"created_at": "2024-01-15T10:00:00Z"
},
{
"number": "919999888877",
"status": "pending",
"checked_at": null,
"created_at": "2024-01-15T10:00:00Z"
}
],
"created_at": "2024-01-15T10:00:00Z",
"last_updated": "2024-01-15T10:31:00Z"
}
Check WhatsApp Number Verification Status with Python
import requests
# Your API key
api_key = "your_api_key"
# Campaign ID to check
campaign_id = 123
# API endpoint
url = f"https://wbiztool.com/api/v1/verification/status/?campaign_id={campaign_id}"
# Request headers
headers = {
"Authorization": f"Bearer {api_key}"
}
# Make the request
response = requests.get(url, headers=headers)
result = response.json()
print("Overall Status:", result.get("overall_status"))
print("Progress:", result.get("progress"))
# Check individual results
for item in result.get("results", []):
print(f"Number: {item['number']}, Status: {item['status']}")
Check WhatsApp Number Verification Status with PHP
Check WhatsApp Number Verification Status with Node.js
const axios = require('axios');
const apiKey = "your_api_key";
const campaignId = 123;
const url = `https://wbiztool.com/api/v1/verification/status/?campaign_id=${campaignId}`;
const headers = {
"Authorization": `Bearer ${apiKey}`
};
axios.get(url, { headers })
.then(response => {
const result = response.data;
console.log("Overall Status:", result.overall_status);
console.log("Progress:", result.progress);
// Display individual results
result.results.forEach(item => {
console.log(`Number: ${item.number}, Status: ${item.status}`);
});
})
.catch(error => {
console.error("Error:", error.response.data);
});
Check WhatsApp Number Verification Status with Java
import java.io.IOException;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
import java.net.URI;
import com.google.gson.Gson;
import com.google.gson.JsonObject;
import com.google.gson.JsonArray;
public class VerificationStatus {
public static void main(String[] args) throws IOException, InterruptedException {
String apiKey = "your_api_key";
int campaignId = 123;
String url = "https://wbiztool.com/api/v1/verification/status/?campaign_id=" + campaignId;
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
.uri(URI.create(url))
.header("Authorization", "Bearer " + apiKey)
.GET()
.build();
HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
Gson gson = new Gson();
JsonObject result = gson.fromJson(response.body(), JsonObject.class);
System.out.println("Overall Status: " + result.get("overall_status").getAsString());
System.out.println("Campaign Name: " + result.get("campaign_name").getAsString());
JsonObject progress = result.getAsJsonObject("progress");
System.out.println("Total: " + progress.get("total").getAsInt());
System.out.println("Verified: " + progress.get("verified").getAsInt());
System.out.println("Pending: " + progress.get("pending").getAsInt());
System.out.println("Completion: " + progress.get("completed_percentage").getAsDouble() + "%");
}
}
Status Values
pending
- Number verification is queued but not yet startedverified
- Number is a valid WhatsApp numberinvalid
- Number is not a valid WhatsApp number or group
Overall Status Values
pending
- All numbers are still waiting to be processedprocessing
- Some numbers have been processed, others are still pendingcompleted
- All numbers have been processed