Email verification for SaaS signups that stops fake accounts

import RocketVerifier from '@rocketverifier/sdk';

const rv = new RocketVerifier(process.env.RV_API_KEY);

export async function checkSignupEmail(email) {
  const result = await rv.verify(email);

  if (result.status === 'deliverable') return { ok: true };

  // "jane@gmial.com" → suggest "jane@gmail.com"
  if (result.didYouMean) return { ok: false, suggestion: result.didYouMean };

  // throwaway inboxes
  if (result.domain.disposable || result.subStatus === 'disposable') {
    return { ok: false, error: 'Please use a permanent email address.' };
  }

  if (result.status === 'undeliverable') {
    return { ok: false, error: 'This address cannot receive email.' };
  }

  // risky or unknown: let them in, flag for review
  return { ok: true, review: result.subStatus };
}

import os
from rocketverifier import RocketVerifier

rv = RocketVerifier(os.environ["RV_API_KEY"])

def check_signup_email(email):
    result = rv.verify(email)

    if result.status == "deliverable":
        return {"ok": True}
    if result.did_you_mean:
        return {"ok": False, "suggestion": result.did_you_mean}
    if result.domain.disposable or result.sub_status == "disposable":
        return {"ok": False, "error": "Please use a permanent email address."}
    if result.status == "undeliverable":
        return {"ok": False, "error": "This address cannot receive email."}

    # risky or unknown: let them in, flag for review
    return {"ok": True, "review": result.sub_status}

$ curl -X POST https://api.rocketverifier.com/v1/verify \
  -H "Authorization: Bearer $RV_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "trial4free@mailinator.com"}'

{
  "status": "undeliverable",
  "sub_status": "disposable",
  "domain": { "name": "mailinator.com", "disposable": "yes", ... },
  "did_you_mean": null
}