WhatsApp नंबर वेरिफिकेशन स्टेटस (API)

किसी नंबर वेरिफिकेशन टास्क की प्रोग्रेस जांचें और उसके हर नंबर का नतीजा पाएं। वेरिफिकेशन टास्क बनाने के बाद, टास्क पूरा होने तक इस एंडपॉइंट को बार-बार कॉल (poll) करें।

छोटा उदाहरण#

curl "https://wbiztool.com/api/v1/verification/status/?campaign_id=4521" \
  -H "Authorization: Bearer YOUR_API_KEY"

import requests

response = requests.get(
    "https://wbiztool.com/api/v1/verification/status/",
    headers={"Authorization": "Bearer YOUR_API_KEY"},
    params={"campaign_id": 4521},
    timeout=60,
)
result = response.json()  # read the body even when the HTTP code is 4xx or 5xx

if result["status"] == "success":
    progress = result["progress"]
    print(result["overall_status"], f"{progress['completed_percentage']}% done")
    for item in result["results"]:
        print(item["number"], item["status"])
else:
    print(f"Failed ({response.status_code}):", result["message"])

// Node.js 18+ (built-in fetch). Save as .mjs to use top-level await.
const url = new URL("https://wbiztool.com/api/v1/verification/status/");
url.searchParams.set("campaign_id", "4521");

const response = await fetch(url, {
  headers: { Authorization: "Bearer YOUR_API_KEY" },
});
const result = await response.json(); // read the body even when the HTTP code is 4xx or 5xx

if (result.status === "success") {
  console.log(result.overall_status, `${result.progress.completed_percentage}% done`);
  for (const item of result.results) {
    console.log(item.number, item.status);
  }
} else {
  console.error(`Failed (${response.status}):`, result.message);
}

<?php
$ch = curl_init('https://wbiztool.com/api/v1/verification/status/?campaign_id=4521');
curl_setopt_array($ch, [
    CURLOPT_HTTPHEADER     => ['Authorization: Bearer YOUR_API_KEY'],
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_TIMEOUT        => 60,
]);
$result = json_decode(curl_exec($ch), true);
curl_close($ch);

if (($result['status'] ?? '') === 'success') {
    echo $result['overall_status'] . ' - ' . $result['progress']['completed_percentage'] . "% done\n";
    foreach ($result['results'] as $item) {
        echo $item['number'] . ': ' . $item['status'] . "\n";
    }
} else {
    echo 'Failed: ' . ($result['message'] ?? 'no response');
}

रिक्वेस्ट पैरामीटर#

रिस्पॉन्स#

सफल रिक्वेस्ट HTTP 200 लौटाती है:

{
  "status": "success",
  "campaign_id": 4521,
  "campaign_name": "Website leads - September",
  "overall_status": "processing",
  "progress": {
    "total": 3,
    "pending": 1,
    "verified": 1,
    "invalid": 1,
    "completed_percentage": 66.67
  },
  "results": [
    {
      "number": "14155550123",
      "status": "pending",
      "checked_at": null,
      "created_at": "2026-09-16T10:15:00.483101+00:00"
    },
    {
      "number": "919876543210",
      "status": "verified",
      "checked_at": "2026-09-16T10:16:12.204551+00:00",
      "created_at": "2026-09-16T10:15:00.482913+00:00"
    },
    {
      "number": "919876543211",
      "status": "invalid",
      "checked_at": "2026-09-16T10:16:19.915372+00:00",
      "created_at": "2026-09-16T10:15:00.483020+00:00"
    }
  ],
  "created_at": "2026-09-16T10:15:00.471820+00:00",
  "last_updated": "2026-09-16T10:15:00.471820+00:00"
}

सभी टाइमस्टैम्प UTC में ISO 8601 फॉर्मेट में होते हैं, माइक्रोसेकंड और +00:00 ऑफसेट के साथ, उदाहरण के लिए 2026-09-16T10:16:12.204551+00:00।

नंबर स्टेटस वैल्यू#

कुल स्टेटस वैल्यू#

अगर कुछ जांचें कैंसल हुई थीं, तो completed टास्क में completed_percentage 100 से कम दिख सकता है, क्योंकि कैंसल हुए नंबर total में गिने जाते हैं लेकिन प्रतिशत में नहीं।

एरर#

एरर होने पर status = "error" वाली JSON बॉडी और HTTP एरर कोड लौटता है:

{ "status": "error", "message": "Campaign not found" }

सुझाव#

• बहुत जल्दी-जल्दी पोल न करें। बैकग्राउंड में हर रन में ज़्यादा से ज़्यादा 10 नंबर जांचे जाते हैं, इसलिए हर 30 से 60 सेकंड में जांचना काफी है, और बड़े टास्क में काफी समय लग सकता है।
• जब overall_status completed हो जाए, तो पोल करना बंद करें।
• pending पर अटका है? वेरिफिकेशन के लिए उसी वर्कस्पेस में WhatsApp सेटिंग्स में कनेक्टेड एक WhatsApp नंबर ज़रूरी है। इसके बिना नंबर कभी नहीं जांचे जाते। जब आपका कनेक्टेड नंबर संदेश भेजने में व्यस्त हो, तब भी जांच रुकी रहती है।
• बड़े टास्क: यह एंडपॉइंट एक ही रिस्पॉन्स में हर नंबर लौटाता है। नतीजे पेज-दर-पेज पढ़ने के लिए, या केवल verified नंबरों के लिए, वेरिफिकेशन नतीजे इस्तेमाल करें।