Skip to content

EnrowAPI/email-verifier-js

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

6 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Email Verifier - JavaScript Library

npm version License: MIT GitHub stars Last commit

Verify email addresses for deliverability with deterministic verification that works on catch-all domains. Integrate email validation into your workflow to reduce bounce rates and protect sender reputation.

Powered by Enrow — deterministic email verification, not probabilistic.

Installation

npm install email-verifier

Requires Node.js 18+. Zero dependencies.

Simple Usage

import { verifyEmail, getVerificationResult } from 'email-verifier';

const verification = await verifyEmail({
  apiKey: 'your_api_key',
  email: 'tcook@apple.com',
});

const result = await getVerificationResult('your_api_key', verification.id);

console.log(result.email);          // tcook@apple.com
console.log(result.qualification);  // valid

verifyEmail returns a verification ID. The verification runs asynchronously — call getVerificationResult to retrieve the result once it's ready. You can also pass a webhook URL to get notified automatically.

What you get back

{
  "email": "tcook@apple.com",
  "qualification": "valid"
}

Bulk verification

import { verifyEmails, getVerificationResults } from 'email-verifier';

const batch = await verifyEmails({
  apiKey: 'your_api_key',
  verifications: [
    'tcook@apple.com',
    'satya@microsoft.com',
    'jensen@nvidia.com',
  ],
});

// batch.batchId, batch.total, batch.status

const results = await getVerificationResults('your_api_key', batch.batchId);
// results.results — array of VerificationResult

Up to 5,000 verifications per batch. Pass a webhook URL to get notified when the batch completes.

Error handling

try {
  await verifyEmail({ apiKey: 'bad_key', email: 'test@test.com' });
} catch (error) {
  // error.message contains the API error description
  // Common errors:
  // - "Invalid or missing API key" (401)
  // - "Your credit balance is insufficient." (402)
  // - "Rate limit exceeded" (429)
}

Getting an API key

Register at app.enrow.io to get your API key. You get 50 free credits (= 200 free verifications) with no credit card required. Each verification costs 0.25 credits.

Paid plans start at $17/mo up to $497/mo. See pricing.

Documentation

License

MIT — see LICENSE for details.

About

Verify email addresses for deliverability with catch-all verification — JavaScript/TypeScript library powered by Enrow

Topics

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors