Skip to main content
GET
/
api
/
v1
/
email-verification
/
stats
Get Verification Stats
curl --request GET \
  --url https://api.example.com/api/v1/email-verification/stats
{
  "totalVerified": 123,
  "totalValid": 123,
  "totalInvalid": 123,
  "totalUnknown": 123,
  "totalVerifications": 123,
  "validPercentage": 123
}

Documentation Index

Fetch the complete documentation index at: https://docs.mailbreeze.com/llms.txt

Use this file to discover all available pages before exploring further.

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}%`);

​
Response

​
totalVerified
integer
Total number of emails verified.
​
totalValid
integer
Count of valid emails.
​
totalInvalid
integer
Count of invalid emails.
​
totalUnknown
integer
Count of unknown/risky emails.
​
totalVerifications
integer
Total verification requests processed.
​
validPercentage
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

MetricDescription
totalVerifiedTotal unique emails verified
totalValidEmails confirmed as deliverable
totalInvalidEmails that will bounce
totalUnknownEmails that couldn’t be verified or are risky
totalVerificationsTotal verification requests (including retries)
validPercentagePercentage 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.