lumail.emails.verify

Legacy SDK method. Prefer lumail.verify().

MethodPOST

/api/v2/emails/verify

Request Examples

import { Lumail } from "lumail";

const lumail = new Lumail({ apiKey: process.env.LUMAIL_API_KEY });
const { data, error } = await lumail.emails.verify({
  email: "[email protected]",
});
if (error) {
  throw error;
}
console.log(data.valid);

Response Examples

{ "valid": true }

Prefer lumail.verify().

emails.verify({ email: string }): Promise<LumailResult<VerifyEmailResponse>>

Still returns { valid: true } or { valid: false, error, code } from /api/v2/emails/verify. A timeout is { data: null, error: { name: "timeout" } }. { valid: false, error, code } is still HTTP 200 and lands in data.

Body Parameters

Name	Type	Description
`email`	string	Required. Address to check.

Response Fields

Field	Type	Description
`valid`	boolean	`true` when the address passes. `false` on a completed check that failed.
`warnings`	string[]	Optional warnings on either outcome.
`error`	string	Present when `valid` is `false`. Human-readable reason.
`code`	`"invalid_format"` / `"disposable_email"` / `"spam_domain"` / `"invalid_domain"` / `"test_email"` / `"internal_error"`	Present when `valid` is `false`.
`suggestion`	string	Optional correction when `valid` is `false`.

PreviousErrors NextAPI Tokens