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.

Source Distribution

email-verifier-1.0.0.tar.gz (5.3 kB view hashes)

Uploaded source

Built Distribution

email_verifier-1.0.0-py3-none-any.whl (8.2 kB view hashes)

Uploaded py3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page