mxcheck

Validate email addresses with syntax checking, MX record lookup, disposable detection, and typo suggestions. Powered by mxcheck.dev.

Install

npm install mxcheck

Usage

import mxcheck from "mxcheck";

const result = await mxcheck("[email protected]");
console.log(result.valid); // true
console.log(result.score); // 0.9

Catch typos

const result = await mxcheck("[email protected]");
console.log(result.suggestion); // "[email protected]"

Detect disposable emails

const result = await mxcheck("[email protected]");
console.log(result.checks.disposable); // true

Express.js middleware

import mxcheck from "mxcheck";

app.post("/signup", async (req, res) => {
  const result = await mxcheck(req.body.email);

  if (!result.valid) {
    return res.status(400).json({ error: result.reason });
  }

  if (result.checks.disposable) {
    return res.status(400).json({ error: "Disposable emails not allowed" });
  }

  // proceed with signup...
});

Response

{
  "email": "[email protected]",
  "valid": true,
  "score": 0.9,
  "reason": null,
  "checks": {
    "syntax": { "valid": true, "reason": null },
    "mx": { "valid": true, "records": ["gmail-smtp-in.l.google.com"], "reason": null },
    "disposable": false,
    "role_account": false,
    "free_provider": true
  },
  "suggestion": null,
  "meta": {
    "domain": "gmail.com",
    "local_part": "user",
    "duration_ms": 5
  }
}

Options

mxcheck("[email protected]", {
  timeout: 5000, // request timeout in ms (default: 10000)
});

API

Free tier: 3,000 requests/month. Get an API key on RapidAPI for higher limits.

License

MIT