Wholesale & White-Label Email Verification API

import os
import requests
from fastapi import FastAPI, HTTPException
from pydantic import BaseModel

app = FastAPI()
MAILVERI_API_KEY = os.environ["MAILVERI_API_KEY"]

class VerifyRequest(BaseModel):
    email: str

@app.post("/api/v1/verify")
def verify_customer_email(payload: VerifyRequest):
    # Forward verification request to MailVeri Wholesale API
    resp = requests.post(
        "https://api.mailveri.com/v1/verify-mail/",
        headers={"Authorization": f"Bearer {MAILVERI_API_KEY}"},
        json={"email": payload.email},
        timeout=15,
    )
    if resp.status_code != 200:
        raise HTTPException(status_code=502, detail="Verification upstream error")

    data = resp.json()
    # Return 100% custom white-label response under your own SaaS brand
    return {
        "email": data.get("email"),
        "deliverability": data.get("status"),
        "safe_to_send": data.get("status") == "VALID",
        "is_catch_all": data.get("is_catch_all", False),
        "is_disposable": data.get("is_disposable", False),
        "is_role_account": data.get("is_role_account", False),
    }

// Node.js / Express White-Label Verification Endpoint
app.post('/api/v1/verify', async (req, res) => {
  const { email } = req.body;

  const upstream = 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 }),
  });

  const data = await upstream.json();

  // Deduct 1 credit from your customer's internal SaaS wallet only when conclusive
  const isBillable = data.status && !data.status.startsWith('UNKNOWN');

  return res.json({
    address: data.email,
    verdict: data.status,
    billable: isBillable,
    flags: {
      disposable: Boolean(data.is_disposable),
      catchAll: Boolean(data.is_catch_all),
      roleAccount: Boolean(data.is_role_account),
    },
  });
});