Get Verification Stats
curl --request GET \
--url https://api.example.com/api/v1/email-verification/statsimport requests
url = "https://api.example.com/api/v1/email-verification/stats"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/api/v1/email-verification/stats', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v1/email-verification/stats",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/email-verification/stats"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/v1/email-verification/stats")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/email-verification/stats")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"totalVerified": 123,
"totalValid": 123,
"totalInvalid": 123,
"totalUnknown": 123,
"totalVerifications": 123,
"validPercentage": 123
}Verification
Get Verification Stats
Get aggregate verification statistics
GET
/
api
/
v1
/
email-verification
/
stats
Get Verification Stats
curl --request GET \
--url https://api.example.com/api/v1/email-verification/statsimport requests
url = "https://api.example.com/api/v1/email-verification/stats"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://api.example.com/api/v1/email-verification/stats', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "https://api.example.com/api/v1/email-verification/stats",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.example.com/api/v1/email-verification/stats"
req, _ := http.NewRequest("GET", url, nil)
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("https://api.example.com/api/v1/email-verification/stats")
.asString();require 'uri'
require 'net/http'
url = URI("https://api.example.com/api/v1/email-verification/stats")
http = Net::HTTP.new(url.host, url.port)
http.use_ssl = true
request = Net::HTTP::Get.new(url)
response = http.request(request)
puts response.read_body{
"totalVerified": 123,
"totalValid": 123,
"totalInvalid": 123,
"totalUnknown": 123,
"totalVerifications": 123,
"validPercentage": 123
}Retrieve aggregate statistics for all email verifications including totals, result breakdowns, and credit usage.
Examples
import { MailBreeze } from "mailbreeze";
const mailbreeze = new MailBreeze({ apiKey: "sk_live_xxx" });
const stats = await mailbreeze.verification.stats();
console.log(`Total verified: ${stats.totalVerified}`);
console.log(`Total valid: ${stats.totalValid}`);
console.log(`Total invalid: ${stats.totalInvalid}`);
console.log(`Total unknown: ${stats.totalUnknown}`);
console.log(`Total verifications: ${stats.totalVerifications}`);
console.log(`Valid percentage: ${stats.validPercentage}%`);
from mailbreeze import MailBreeze
client = MailBreeze(api_key="sk_live_xxx")
stats = await client.verification.stats()
print(f"Total verified: {stats.total_verified}")
print(f"Total valid: {stats.total_valid}")
print(f"Total invalid: {stats.total_invalid}")
print(f"Total unknown: {stats.total_unknown}")
print(f"Total verifications: {stats.total_verifications}")
print(f"Valid percentage: {stats.valid_percentage}%")
client := mailbreeze.NewClient("sk_live_xxx")
stats, err := client.Verification.Stats(ctx)
if err != nil {
log.Fatal(err)
}
fmt.Printf("Total verified: %d\n", stats.TotalVerified)
fmt.Printf("Total valid: %d\n", stats.TotalValid)
fmt.Printf("Total invalid: %d\n", stats.TotalInvalid)
fmt.Printf("Total unknown: %d\n", stats.TotalUnknown)
fmt.Printf("Total verifications: %d\n", stats.TotalVerifications)
fmt.Printf("Valid percentage: %.1f%%\n", stats.ValidPercentage)
$mailbreeze = new MailBreeze('sk_live_xxx');
$response = $mailbreeze->verification->stats();
$stats = $response['data'];
echo "Total verified: " . $stats['totalVerified'] . "\n";
echo "Total valid: " . $stats['totalValid'] . "\n";
echo "Total invalid: " . $stats['totalInvalid'] . "\n";
echo "Total unknown: " . $stats['totalUnknown'] . "\n";
echo "Total verifications: " . $stats['totalVerifications'] . "\n";
echo "Valid percentage: " . $stats['validPercentage'] . "%\n";
let client = MailBreeze::new("sk_live_xxx")?;
let stats = client.verification.stats().await?;
println!("Total verified: {}", stats.total_verified);
println!("Total valid: {}", stats.total_valid);
println!("Total invalid: {}", stats.total_invalid);
println!("Total unknown: {}", stats.total_unknown);
println!("Total verifications: {}", stats.total_verifications);
println!("Valid percentage: {}%", stats.valid_percentage);
curl "https://api.mailbreeze.com/api/v1/email-verification/stats" \
-H "Authorization: Bearer sk_live_xxx"
Response
integer
Total number of emails verified.
integer
Count of valid emails.
integer
Count of invalid emails.
integer
Count of unknown/risky emails.
integer
Total verification requests processed.
number
Percentage of valid emails (0-100).
Example Response
{
"success": true,
"data": {
"totalVerified": 238,
"totalValid": 13,
"totalInvalid": 185,
"totalUnknown": 24,
"totalVerifications": 18,
"validPercentage": 5
},
"meta": {
"timestamp": "2025-12-27T13:39:03.934Z",
"requestId": "1444aadd-b2c0-4e6d-ba74-c1f50a4a5462",
"path": "/api/v1/email-verification/stats"
}
}
Understanding the Stats
| Metric | Description |
|---|---|
| totalVerified | Total unique emails verified |
| totalValid | Emails confirmed as deliverable |
| totalInvalid | Emails that will bounce |
| totalUnknown | Emails that couldn’t be verified or are risky |
| totalVerifications | Total verification requests (including retries) |
| validPercentage | Percentage of valid emails: (totalValid / totalVerified) * 100 |
Calculating List Quality
if (stats.validPercentage > 95) {
console.log("Excellent list quality");
} else if (stats.validPercentage > 90) {
console.log("Good list quality");
} else if (stats.validPercentage > 80) {
console.log("Fair list quality - consider cleaning");
} else {
console.log("Poor list quality - clean before sending");
}
Stats are calculated across all time. For date-filtered stats, use the date range parameters in your dashboard.