Email Verification Report

interface EmailVerificationResponse {
  email: {
    status: 'Approved' | 'Declined' | 'In Review' | 'Not Finished';
    email: string;                            // The email address being verified
    is_breached: boolean;                     // Whether found in known data breaches
    breaches: {
      name: string;                           // Name of the breached service
      domain: string;                         // Domain affected by the breach
      logo_path: string;                      // URL to the service's logo
      breach_date: string;                    // Date of breach (YYYY-MM-DD)
      description: string;                    // Breach description
      is_verified: boolean;                   // Whether breach is verified
      data_classes: string[];                 // Types of exposed data
      breach_emails_count: number;            // Number of affected email addresses
    }[];
    is_disposable: boolean;                   // Indicates a disposable provider
    is_undeliverable: boolean;                // Indicates undeliverable address
    verification_attempts: number;            // Number of verification attempts
    verified_at: string;                      // ISO 8601 timestamp
    warnings: {
      risk: string;                           // Warning tag
      additional_data: string | null;         // Additional context, if any
      log_type: 'information' | 'warning' | 'error';
      short_description: string;              // Short, user-facing message
      long_description: string;               // Detailed description
    }[];
  }
}

{
  "email": {
    "status": "Approved",
    "email": "[email protected]",
    "is_breached": true,
    "breaches": [
      {
        "name": "TAPAirPortugal",
        "domain": "flytap.com",
        "logo_path": "https://logos.haveibeenpwned.com/TAPAirPortugal.png",
        "breach_date": "2022-08-25",
        "description": "In August 2022, TAP Air Portugal suffered a ransomware attack with exposed personal data.",
        "is_verified": true,
        "data_classes": [
          "dates_of_birth",
          "email_addresses",
          "genders",
          "names",
          "nationalities",
          "phone_numbers",
          "physical_addresses",
          "salutations",
          "spoken_languages"
        ],
        "breach_emails_count": 6083479
      }
    ],
    "is_disposable": false,
    "is_undeliverable": false,
    "verification_attempts": 1,
    "verified_at": "2025-09-15T17:36:19.963451Z",
    "warnings": [
      {
        "risk": "BREACHED_EMAIL_DETECTED",
        "additional_data": null,
        "log_type": "information",
        "short_description": "Breached email detected",
        "long_description": "This email address was found in one or more known data breaches."
      }
    ]
  }
}