FoxGuard Widget

<!-- 1. Load the widget script -->
<script src="https://api.verifox.ai/v1/widget/widget.js"></script>

<!-- 2. Initialize with your config -->
<script>
  Verifox.init({
    apiKey: "vfx_your_widget_key",
    blockDisposable: true,
    blockFree: false,
    showTooltip: true,
    redHighlight: true,
    lang: "en",
    messages: {
      disposable: "Disposable emails are not allowed.",
      free: "Please use a work email address.",
      valid: "Email looks good!",
      warning: "This email may not be deliverable."
    },
    onValid: function(e) { console.log("valid", e.email); },
    onInvalid: function(e) { console.log("blocked", e.email, e.reason); }
  });
</script>

// widget.js returns the FoxGuard JavaScript SDK.
// Once loaded, window.Verifox is available with these methods:

Verifox.init(options)      // Initialize — call once on page load
Verifox.reattach()         // Re-scan DOM for new inputs (SPA use)
Verifox.validate(email)    // Manually validate an email string
Verifox.destroy()          // Remove all listeners and tooltips

<!-- Protect only the signup form's email input -->
<script>
  Verifox.init({
    apiKey: "vfx_your_widget_key",
    selector: "#signup-form input[type='email']"
  });
</script>

// data-verifox-* attribute reference:

data-verifox-ignore="true"               // Skip this input entirely
data-verifox-block-disposable="true|false"  // Override blockDisposable
data-verifox-block-free="true|false"        // Override blockFree
data-verifox-red-highlight="true|false"     // Override redHighlight
data-verifox-show-tooltip="true|false"      // Override showTooltip
data-verifox-msg-disposable="..."           // Override disposable message
data-verifox-msg-free="..."                 // Override free-email message
data-verifox-msg-valid="..."               // Override valid message
data-verifox-msg-warning="..."             // Override warning message

const form = document.getElementById("signup-form");
const emailInput = document.getElementById("email");

Verifox.init({
  apiKey: "vfx_your_widget_key",
  blockDisposable: true,
  blockFree: true,
  onInvalid: function({ email, reason }) {
    // Mark the input as blocked
    emailInput.dataset.verifoxBlocked = "true";
  },
  onValid: function({ email }) {
    delete emailInput.dataset.verifoxBlocked;
  }
});

form.addEventListener("submit", function(e) {
  // Check data attribute set by widget
  if (emailInput.dataset.verifoxStatus === "invalid") {
    e.preventDefault();
    alert("Please enter a valid work email.");
    return;
  }

  // Or check the blocked flag you set in onInvalid
  if (emailInput.dataset.verifoxBlocked === "true") {
    e.preventDefault();
  }
});

// After validation, FoxGuard sets these attributes on the input element:

data-verifox-status="valid"     // Email passed all checks
data-verifox-status="invalid"   // Email was blocked (disposable/free/unreachable)
data-verifox-status="warning"   // Email is risky but not blocked
data-verifox-status="pending"   // Validation in progress

// The reason string passed to onInvalid:
"disposable"   // Matched a known disposable provider
"free"         // Matched a free provider (when blockFree: true)
"invalid"      // Failed SMTP / syntax / MX check

curl -X GET "https://api.verifox.ai/v1/widget/validate?email=john@example.com&api_key=vfx_widget_key" \
  -H "X-API-Key: vfx_your_api_key"

{
  "success": true,
  "result": {
    "email": "john@example.com",
    "domain": "example.com",
    "status": "safe",
    "isValid": true,
    "isFree": false,
    "isRole": false,
    "isDisposable": false,
    "suggestion": null,
    "smtp": {
      "deliverable": true,
      "catchAll": false,
      "hostExists": true
    }
  }
}

curl -X POST "https://api.verifox.ai/v1/widget/public-verify" \
  -H "X-API-Key: vfx_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{"email": "john@example.com", "fingerprint": "fp_abc123"}'

{
  "success": true,
  "remaining": 3,
  "result": {
    "email": "john@example.com",
    "status": "safe",
    "isValid": true,
    "isFree": false,
    "isRole": false,
    "isDisposable": false,
    "suggestion": null,
    "smtp": {
      "deliverable": true,
      "catchAll": false,
      "hostExists": true
    }
  }
}