> ## 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.

# Get Verification Stats

> Get aggregate verification statistics

Retrieve aggregate statistics for all email verifications including totals, result breakdowns, and credit usage.

## Examples

<CodeGroup>
  ```typescript JavaScript theme={null}
  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}%`);
  ```

  ```python Python theme={null}
  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}%")
  ```

  ```go Go theme={null}
  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)
  ```

  ```php PHP theme={null}
  $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";
  ```

  ```rust Rust theme={null}
  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);
  ```

  ```bash cURL theme={null}
  curl "https://api.mailbreeze.com/api/v1/email-verification/stats" \
    -H "Authorization: Bearer sk_live_xxx"
  ```
</CodeGroup>

## Response

<ResponseField name="totalVerified" type="integer">
  Total number of emails verified.
</ResponseField>

<ResponseField name="totalValid" type="integer">
  Count of valid emails.
</ResponseField>

<ResponseField name="totalInvalid" type="integer">
  Count of invalid emails.
</ResponseField>

<ResponseField name="totalUnknown" type="integer">
  Count of unknown/risky emails.
</ResponseField>

<ResponseField name="totalVerifications" type="integer">
  Total verification requests processed.
</ResponseField>

<ResponseField name="validPercentage" type="number">
  Percentage of valid emails (0-100).
</ResponseField>

```json Example Response theme={null}
{
  "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

```typescript theme={null}
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");
}
```

<Note>
  Stats are calculated across all time. For date-filtered stats, use the date range parameters in your dashboard.
</Note>