Email Verification API

Verify an address with POST /api/v2/verify or lumail.verify().

MethodPOST

/api/v2/verify

Request Examples

import { Lumail } from "lumail";

const lumail = new Lumail({ apiKey: process.env.LUMAIL_API_KEY });
const { data, error } = await lumail.verify("[email protected]");
if (error) {
  throw error;
}
if (!data.accept) {
  throw data.issues[0];
}
console.log(data.result, data.score, data.suggestion);

Response Examples

{
  "object": "email_verification",
  "id": "vr_abc123",
  "email": "[email protected]",
  "result": "risky",
  "accept": true,
  "status": "completed",
  "score": 80,
  "suggestion": null,
  "issues": [],
  "quota": {
    "limit": 10000,
    "used": 12,
    "remaining": 9988,
    "resets_at": "2026-10-01T00:00:00.000Z"
  },
  "retry_at": null,
  "cache_hit": false
}

POST /api/v2/verify · lumail.verify()

Checks syntax, disposable and blocked domains, spam-like or role-based mailbox names, domain typos, trusted global history, and DNS mail routing. Permission: emails.

HTTP 200 for both accept and reject. Use accept for the policy decision and issues for every error or warning. Full field reference and score bands: Verify.

Older emails.verify path: emails.verify.

PreviousSend Transactional Email NextCreate Subscriber