Create Verification API

Validate phone numbers, verify customer contacts, and ensure delivery success before sending important messages 

End Point: https://wbiztool.com/api/v1/verification/create/
Request Type: POST

Download Postman Collection
Required Fields in Request
  • api_key (String) - Your API Key (Given on API Keys page) (Can be sent in Authorization header as Bearer token)
  • numbers (Array) - Array of phone numbers to verify (with country codes, e.g., ["919876543210", "911234567890"])
  • campaign_name (String, Optional) - Name for the verification campaign (auto-generated if not provided)
Fields in Response
  • status (String) - "success" if verification task created successfully
  • message (String) - Readable message about the request status
  • campaign_id (Integer) - ID of the created verification campaign
  • numbers_count (Integer) - Number of valid phone numbers submitted for verification
  • numbers_submitted (Array) - Array of cleaned phone numbers that were submitted
Example

The following example shows how to create a verification task for multiple phone numbers.

curl -X POST https://wbiztool.com/api/v1/verification/create/ \
-H "Authorization: Bearer your_api_key" \
-H "Content-Type: application/json" \
-d '{
    "numbers": ["919876543210", "911234567890", "919999888877"],
    "campaign_name": "Customer Numbers Verification"
}'

// Response
{
    "status": "success",
    "message": "Verification task created successfully",
    "campaign_id": 123,
    "numbers_count": 3,
    "numbers_submitted": ["919876543210", "911234567890", "919999888877"]
}

Create WhatsApp Number Verification Task with Python

import requests
import json

# Your API key
api_key = "your_api_key"

# Phone numbers to verify
numbers = ["919876543210", "911234567890", "919999888877"]

# API endpoint
url = "https://wbiztool.com/api/v1/verification/create/"

# Request headers
headers = {
    "Authorization": f"Bearer {api_key}",
    "Content-Type": "application/json"
}

# Request data
data = {
    "numbers": numbers,
    "campaign_name": "Customer Numbers Verification"
}

# Make the request
response = requests.post(url, headers=headers, json=data)
result = response.json()

print("Status:", result.get("status"))
print("Campaign ID:", result.get("campaign_id"))
print("Numbers Count:", result.get("numbers_count"))

Create WhatsApp Number Verification Task with PHP

 $numbers,
    "campaign_name" => "Customer Numbers Verification"
];

$headers = [
    "Authorization: Bearer " . $api_key,
    "Content-Type: application/json"
];

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($data));
curl_setopt($ch, CURLOPT_HTTPHEADER, $headers);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

$response = curl_exec($ch);
$result = json_decode($response, true);

echo "Status: " . $result["status"] . "\n";
echo "Campaign ID: " . $result["campaign_id"] . "\n";
echo "Numbers Count: " . $result["numbers_count"] . "\n";

curl_close($ch);
?>

Create WhatsApp Number Verification Task with Node.js

const axios = require('axios');

const apiKey = "your_api_key";
const url = "https://wbiztool.com/api/v1/verification/create/";

// Phone numbers to verify
const numbers = ["919876543210", "911234567890", "919999888877"];

const data = {
    numbers: numbers,
    campaign_name: "Customer Numbers Verification"
};

const headers = {
    "Authorization": `Bearer ${apiKey}`,
    "Content-Type": "application/json"
};

axios.post(url, data, { headers })
    .then(response => {
        const result = response.data;
        console.log("Status:", result.status);
        console.log("Campaign ID:", result.campaign_id);
        console.log("Numbers Count:", result.numbers_count);
    })
    .catch(error => {
        console.error("Error:", error.response.data);
    });

Create WhatsApp Number Verification Task 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 java.util.Arrays;
import java.util.HashMap;
import java.util.List;
import java.util.Map;

public class VerificationCreate {
    public static void main(String[] args) throws IOException, InterruptedException {
        String apiKey = "your_api_key";
        String url = "https://wbiztool.com/api/v1/verification/create/";
        
        // Phone numbers to verify
        List numbers = Arrays.asList("919876543210", "911234567890", "919999888877");
        
        Map data = new HashMap<>();
        data.put("numbers", numbers);
        data.put("campaign_name", "Customer Numbers Verification");
        
        Gson gson = new Gson();
        String json = gson.toJson(data);
        
        HttpClient client = HttpClient.newHttpClient();
        HttpRequest request = HttpRequest.newBuilder()
                .uri(URI.create(url))
                .header("Authorization", "Bearer " + apiKey)
                .header("Content-Type", "application/json")
                .POST(HttpRequest.BodyPublishers.ofString(json))
                .build();
        
        HttpResponse response = client.send(request, HttpResponse.BodyHandlers.ofString());
        System.out.println("Response: " + response.body());
    }
}
Important Notes
  • Phone numbers should include country codes (e.g., 91 for India, 1 for USA)
  • Invalid or duplicate numbers will be filtered out automatically
  • The verification process is asynchronous - use the status API to check progress
  • This feature is available for paid plans only
  • Maximum numbers per request depends on your subscription plan