Skip to main content

Python client library for Email Verification API.

Project description


The simplest possible way to verify an email address in Python.


- Author: WHOIS API, Inc.
- Email:
- Site:


To use this library, you'll need to create a free Email Verification API account:

If you haven't done this yet, please do so now.


Documentation available `here <>`_.


To install ``email-verifier`` using `pypi <>`_, simply run:

.. code-block:: console

$ pip install email-verifier

In the root of your project directory.


Once you have `email-verified` installed, you can use it to easily verify any
email address.

.. code-block:: python

from emailverifier import Client
from emailverifier import exceptions

client = Client('Your-api-key')

data = client.get("")
except exceptions.HttpException:
# If you get here, it means service returned HTTP error code
except exceptions.GeneralException:
# If you get here, it means you cannot connect to the service
except exceptions.UndefinedVariableException:
# If you get here, it means you forgot to specify the API key
except exceptions.InvalidArgumentException:
# If you get here, it means you specified invalid argument
# (options should be a dictionary)
# Something else happened related. Maybe you hit CTRL-C
# while the program was running, the kernel is killing your process, or
# something else all together.


# Use data.json_string to get raw data in JSON.
# You can access any response field as a class property
# by converting field name from "camelCase" to "snake_case"
print("Email address: " + data.email_address)
print("Format: " + str(data.format_check))
print("DNS: " + str(data.dns_check))
print("SMTP: " + str(data.smtp_check))
print("Catch all: " + str(data.catch_all_check))
print("Disposable: " + str(data.disposable_check))
print("Free: " + str(data.free_check))
print("Last audit date: " + str(data.audit.audit_updated_date))

Here's the sort of data you might get back when performing a email verification

.. code-block:: json

"emailAddress": "",
"formatCheck": "true",
"smtpCheck": "true",
"dnsCheck": "true",
"freeCheck": "false",
"disposableCheck": "false",
"catchAllCheck": "true",
"mxRecords": [
"audit": {
"auditCreatedDate": "2018-04-19 18:12:45.000 UTC",
"auditUpdatedDate": "2018-04-19 18:12:45.000 UTC"

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for email-verifier, version 1.0.0
Filename, size File type Python version Upload date Hashes
Filename, size email_verifier-1.0.0-py3-none-any.whl (8.2 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size email-verifier-1.0.0.tar.gz (5.3 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page