# does-email-exist

> Validates emails

Latest version **0.2.1** (published 2026-06-29) · MIT license · 0 weekly downloads

## Install

```sh
npm install does-email-exist
pnpm add does-email-exist
yarn add does-email-exist
bun add does-email-exist
```

## Health

**Score 55/100 (C)** — status: active.

Positive: has types; no vulnerabilities; high quality score.

Warnings: low downloads; no esm support; pre 1.0.

## Facts

| | |
|---|---|
| Version | 0.2.1 |
| Published | 2026-06-29 |
| First published | 2022-02-11 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Dependencies | 3 |
| Unpacked size | 32.1 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 4 |
| Author | Playcode |
| Maintainers | ianberdin |
| Keywords | email-validate, disposable-emails, smtp, mx-records |

## Links

- npm: https://www.npmjs.com/package/does-email-exist
- Repository: https://github.com/playcode/does-email-exist
- Homepage: https://playcode.io/ai-website-builder
- Issues: https://github.com/playcode/does-email-exist/issues
- npm.io page: https://npm.io/package/does-email-exist

## Dependencies (3)

- [mailcheck](https://npm.io/package/mailcheck.md) ^1.1.1
- [disposable-email-domains](https://npm.io/package/disposable-email-domains.md) ^1.0.62
- [@types/disposable-email-domains](https://npm.io/package/@types/disposable-email-domains.md) ^1.0.2

## Alternatives

- [@expo/fingerprint](https://npm.io/package/@expo/fingerprint.md) — 6.2M weekly downloads
- [@azure/monitor-opentelemetry-exporter](https://npm.io/package/@azure/monitor-opentelemetry-exporter.md) — 850.0K weekly downloads
- [@azure/monitor-opentelemetry](https://npm.io/package/@azure/monitor-opentelemetry.md) — 624.0K weekly downloads
- [@posthog/ai](https://npm.io/package/@posthog/ai.md) — 423.3K weekly downloads
- [fakefilter](https://npm.io/package/fakefilter.md) — 63.9K weekly downloads

## Recent versions

- 0.2.1 (latest) — 2026-06-29
- 0.2.0 — 2022-02-11
- 0.1.4 — 2022-02-11
- 0.1.3 — 2022-02-11
- 0.1.2 — 2022-02-11
- 0.1.1 — 2022-02-11
- 0.1.0 — 2022-02-11

## README

# Does Email Exist

- Validates SMTP server is running.
- Validates MX records are present on DNS.
- Validates email looks like an email i.e. contains an "@" and a "." to the right of it.
- Validates common typos e.g. example@gmaill.com using [mailcheck](https://github.com/mailcheck/mailcheck).
- Validates email was not generated by disposable email service using [disposable-email-domains](https://github.com/ivolo/disposable-email-domains).
- Validates mailbox exists on SMTP server.

## Maintained by Playcode

This package is maintained by [Playcode](https://playcode.io), the AI website
builder and AI app builder for creating, editing, hosting, and publishing live
websites and web apps.

- [AI Website Builder](https://playcode.io/ai-website-builder)
- [Playcode homepage](https://playcode.io)
- [Watch the demo](https://www.youtube.com/watch?v=aK7E_XtBynA)

## Getting Started

Compatible with node.js only. Not browser ready.

```
npm i does-email-exist --save
```

Usage

```typescript
import validate from 'does-email-exist'
const main = async () => {
  let res = await validate('example@gmail.com')
  // {
  //   "valid": false,
  //   "reason": "smtp",
  //   "validators": {
  //       "regex": {
  //         "valid": true
  //       },
  //       "typo": {
  //         "valid": true
  //       },
  //       "disposable": {
  //         "valid": true
  //       },
  //       "mx": {
  //         "valid": true
  //       },
  //       "smtp": {
  //         "valid": false,
  //         "reason": "553-mail rejected because your IP is in the PBL.",
  //         "code": 553
  //       }
  //   }
  // }

  // Can also be called with these default options
  await validate({
    email: 'name@example.org', // Recipient
    sender: 'name@example.org', // Your correct email address
    helloName: 'localhost',
    validateRegex: true,
    validateMx: true,
    validateTypo: false,
    validateDisposable: true,
    validateSMTP: true,
  })
}
```

[Based on deep-email-validator](https://github.com/mfbx9da4/deep-email-validator)

LICENSE: MIT.

---
_Source: https://npm.io/package/does-email-exist · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._
