Verify Email

import { MailBreeze } from "mailbreeze";

const mailbreeze = new MailBreeze({ apiKey: "sk_live_xxx" });

const result = await mailbreeze.verification.verify({ email: "user@example.com" });

if (result.isValid) {
  console.log("Email is valid - safe to send");
} else {
  console.log(`Invalid: ${result.reason}`);
}

// Check detailed information
console.log(`Result: ${result.result}`);       // "valid", "invalid", "risky", "unknown"
console.log(`Risk score: ${result.riskScore}`); // 0-100
console.log(`Cached: ${result.cached}`);        // true if previously verified

if (result.details) {
  console.log(`Disposable: ${result.details.isDisposable}`);
  console.log(`Free provider: ${result.details.isFreeProvider}`);
  console.log(`Role account: ${result.details.isRoleAccount}`);
}

from mailbreeze import MailBreeze

client = MailBreeze(api_key="sk_live_xxx")

result = await client.verification.verify(email="user@example.com")

if result.is_valid:
    print("Email is valid - safe to send")
else:
    print(f"Invalid: {result.reason}")

# Check detailed information
print(f"Result: {result.result}")        # "valid", "invalid", "risky", "unknown"
print(f"Risk score: {result.risk_score}") # 0-100
print(f"Cached: {result.cached}")         # True if previously verified

if result.details:
    print(f"Disposable: {result.details.is_disposable}")
    print(f"Free provider: {result.details.is_free_provider}")

client := mailbreeze.NewClient("sk_live_xxx")

result, err := client.Verification.Verify(ctx, &mailbreeze.VerifyEmailParams{
    Email: "user@example.com",
})
if err != nil {
    log.Fatal(err)
}

if result.IsValid {
    fmt.Println("Email is valid - safe to send")
} else {
    fmt.Printf("Invalid: %s\n", result.Reason)
}

// Check detailed information
fmt.Printf("Result: %s\n", result.Result)
fmt.Printf("Risk score: %d\n", result.RiskScore)
fmt.Printf("Cached: %t\n", result.Cached)

if result.Details != nil {
    fmt.Printf("Disposable: %t\n", result.Details.IsDisposable)
}

$mailbreeze = new MailBreeze('sk_live_xxx');

$response = $mailbreeze->verification->verify(['email' => 'user@example.com']);
$result = $response['data'];

if ($result['isValid']) {
    echo "Email is valid - safe to send\n";
} else {
    echo "Invalid: " . $result['reason'] . "\n";
}

// Check detailed information
echo "Result: " . $result['result'] . "\n";
echo "Risk score: " . $result['riskScore'] . "\n";
echo "Cached: " . ($result['cached'] ? 'true' : 'false') . "\n";

if (isset($result['details'])) {
    echo "Disposable: " . ($result['details']['isDisposable'] ? 'true' : 'false') . "\n";
}

MailBreeze mailbreeze = MailBreeze.builder()
    .apiKey("sk_live_xxx")
    .build();

VerifyEmailResult result = mailbreeze.verification().verify("user@example.com");

if (result.isValid()) {
    System.out.println("Email is valid - safe to send");
} else {
    System.out.println("Invalid: " + result.getReason());
}

// Check detailed information
System.out.println("Result: " + result.getResult());
System.out.println("Risk score: " + result.getRiskScore());
System.out.println("Cached: " + result.isCached());

if (result.getDetails() != null) {
    System.out.println("Disposable: " + result.getDetails().isDisposable());
}

let client = MailBreeze::new("sk_live_xxx")?;

let result = client.verification.verify("user@example.com").await?;

if result.is_valid {
    println!("Email is valid - safe to send");
} else {
    println!("Invalid: {}", result.reason);
}

// Check detailed information
println!("Result: {}", result.result);
println!("Risk score: {:?}", result.risk_score);
println!("Cached: {}", result.cached);

if let Some(details) = result.details {
    println!("Disposable: {:?}", details.is_disposable);
}

curl -X POST https://api.mailbreeze.com/api/v1/email-verification/single \
  -H "Authorization: Bearer sk_live_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "email": "user@example.com"
  }'