Prevent Amazon SES Bounce Suspensions

import os
import boto3
import requests

MAILVERI_API_KEY = os.environ["MAILVERI_API_KEY"]
ses_client = boto3.client("sesv2", region_name="us-east-1")

def send_verified_ses_email(recipient: str, subject: str, html_body: str) -> dict:
    # Step 1: Pre-check deliverability with MailVeri before calling AWS SES
    check = requests.post(
        "https://api.mailveri.com/v1/verify-mail/",
        headers={"Authorization": f"Bearer {MAILVERI_API_KEY}"},
        json={"email": recipient},
        timeout=10,
    ).json()

    status = check.get("status", "UNKNOWN")
    if status != "VALID":
        # Suppress invalid, disposable, full-inbox, or catch-all addresses to protect AWS SES <2% bounce SLA
        return {"sent": False, "suppressed_reason": status}

    # Step 2: Dispatch via Amazon SES v2 only for verified VALID recipients
    response = ses_client.send_email(
        FromEmailAddress="[email protected]",
        Destination={"ToAddresses": [recipient]},
        Content={
            "Simple": {
                "Subject": {"Data": subject},
                "Body": {"Html": {"Data": html_body}},
            }
        },
    )
    return {"sent": True, "message_id": response["MessageId"]}

import { SESv2Client, SendEmailCommand } from "@aws-sdk/client-sesv2";

const ses = new SESv2Client({ region: "us-east-1" });

export async function dispatchSafeSesEmail(toEmail, subject, htmlContent) {
  const verifyRes = await fetch("https://api.mailveri.com/v1/verify-mail/", {
    method: "POST",
    headers: {
      "Authorization": `Bearer ${process.env.MAILVERI_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ email: toEmail }),
  });

  const { status } = await verifyRes.json();
  if (status !== "VALID") {
    return { skipped: true, status };
  }

  const command = new SendEmailCommand({
    FromEmailAddress: "[email protected]",
    Destination: { ToAddresses: [toEmail] },
    Content: {
      Simple: {
        Subject: { Data: subject },
        Body: { Html: { Data: htmlContent } },
      },
    },
  });

  return await ses.send(command);
}