Disposable email detection for every signup.

# Check one address
curl -X POST https://shieldmx-core-api.slotboard-v.workers.dev/v1/verify \
  -H "Authorization: Bearer $SHIELDMX_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"email": "someone@mailinator.com"}'

// Node 18 or later
const res = await fetch("https://shieldmx-core-api.slotboard-v.workers.dev/v1/verify", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.SHIELDMX_API_KEY}`,
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ email }),
});
const result = await res.json();
if (result.recommendation === "REJECT") {
  // Refuse the signup, or ask for another address
}

# pip install requests
import os
import requests

res = requests.post(
    "https://shieldmx-core-api.slotboard-v.workers.dev/v1/verify",
    headers={"Authorization": f"Bearer {os.environ['SHIELDMX_API_KEY']}"},
    json={"email": email},
    timeout=5,
)
res.raise_for_status()
if res.json()["recommendation"] == "REJECT":
    ...  # Refuse the signup, or ask for another address

{
  "valid_syntax": true,
  "email": "someone@mailinator.com",
  "domain": "mailinator.com",
  "disposable": true,
  "recommendation": "REJECT",
  "evaluated_at": 1792848000
}

{
  "valid_syntax": true,
  "email": "lead@example.com",
  "domain": "example.com",
  "disposable": false,
  "recommendation": "ALLOW",
  "evaluated_at": 1792848000
}