neverbounce 0.2.0

Single verification

>>> from neverbounce import NeverBounce

>>> neverbounce = NeverBounce('my_api_username', 'my_api_key')
>>> verified = neverbounce.verify('martin@martinkosir.net')

>>> print(str(verified))
martin@martinkosir.net: valid

>>> print(verified.email, verified.result_text, verified.result_code, verified.is_valid)
martin@martinkosir.net valid 0 True

Bulk verification

To use this features you need to configure a payment method in NeverBounce account settings.

>>> from neverbounce import NeverBounce
>>> neverbounce = NeverBounce('my_api_username', 'my_api_key')

Create the job and get it’s id:

>>> emails = ['some.email@example.com', 'john.smith@gmail.com']
>>> job_id = neverbounce.create_job(emails).job_id

Periodically check the status of verification job:

>>> job_status = neverbounce.check_job(job_id)

Use the results generator to iterate over verified emails if the job has been completed:

>>> if job_status.is_completed:
...     for verified in neverbounce.results(job_id):
...         print(verified.email, verified.result_text, verified.result_code, verified.is_valid)
some.email@example.com invalid 1 False
john.smith@gmail.com invalid 1 False

Account information

Get the information about your API account:

>>> from neverbounce import NeverBounce
>>> neverbounce = NeverBounce('my_api_username', 'my_api_key')
>>> account = neverbounce.account()

>>> print(str(account))
Credits: 999, Jobs Completed: 22, Jobs Processing: 0

>>> print(account.credits, account.jobs_completed, account.jobs_processing)
999 22 0