emailvalidation/README.md

A module for validating emails using the emailvalidation.co API.

Email Validation
==================

An email validation module using the [emailvalidator.co](http://www.emailvalidator.co/?utm_source=npm&utm_medium=module&utm_campaign=alexleventer) API. This does more than just check syntax, this module actually validates whether the mailbox is active.

Emailvalidator.co has 4-levels of verification:

+ **Level 1**: The API checks for syntax issues and whether the domain belongs to any disposable email domain such as yopmail, mailinator, etc.

+ **Level 2**: The API checks for all the above plus if the domain name is valid, and whether the domain has hosted email servers to accept emails.

+ **Level 3**: The API checks whether the mailbox actually exists along with the above.

+ **Level 4**: The API checks whether the email server has a catch-all account.

You can signup for an account at [emailvalidator.co](http://www.emailvalidator.co/?utm_source=npm&utm_medium=module&utm_campaign=alexleventer)

## Installation

    npm install emailvalidation --save

## Usage

    var Validator = require('emailvalidation');
    var validator = new Validator('your-api-key');

    validator.validate(email, verificationlevel, function(err, response)) {
      console.log(response.IsValid); //Returns true or false
    });