email-verification/verify

What it does

Validates a single email address and returns a deliverability assessment: a status ("deliverable", "risky", "undeliverable", or "unknown"), a reason, and a 0-100 score estimating the chance of successful delivery. It also returns domain details (including acceptAll for catch-all domains, disposable, and free), account details (role, disabled), the mail provider, and a toxic flag.

Primary use cases

• Validating email addresses at signup or form submission to block typos, disposable, and role mailboxes.
• Cleaning a contact list before a send to reduce bounces and protect sender reputation.

Good to know

Pass a single address in email. This checks syntax, the domain's MX records, and mailbox signals; it does not send mail. For catch-all (accept-all) domains, mailbox existence cannot be confirmed directly, so rely on score and domain.acceptAll rather than status alone to decide whether to send. "unknown" means the mail provider could not be reached in time.

Parameters