Skip to main content

Check passwords and emails against HaveIBeenPwnd

Project description

Troy Hunt released a new version of the Have I Been pwnd Database. This time with more anonymity in mind.


  • check if an email was part of a breach
  • check if a password is known from a breach against
    • does not sent passwords to
    • does not sent complete password hashes to
  • zero dependencies except requests (will be removed later)
  • python2 & python3 support
  • tests


You can use HaveIBeenPwnd als command line script or use it as module in other python code.

As command line script

Install HaveIBeenPwnd gobally or in a virtual environment:

$ pip install haveibeenpwnd

This add shortcuts to haveibeenpwnd, so that you call haveibeenpwnd from everywhere. To check a password, simply do this:

$ haveibeenpwnd --password hunter2
The password was found 16092 times in the database.

Remember, haveibeenpwnd does not send the given password into the internet, it sends the first 5 chars of the SHA1 Hash.

To check if a mail has been part of a breach, do this:

$ haveibeenpwnd -m
The email <> was found in following breaches:
The <000webhost> breach (2015-03-01) exposed Email addresses, IP addresses, Names and Passwords
The <8tracks> breach (2017-06-27) exposed Email addresses and Passwords

As module

Check emails:

>>> from haveibeenpwnd import check_email
>>> check_email(""))
>>> check_email("")
{'breaches': [{'Title': '000webhost', ...}]}

and check passwords:

>>> from haveibeenpwnd import check_password
>>> check_password('hunter2')
>>> check_password('lksdflksdpsökfdsödg')


You can install haveibeenpwnd with pip:

$ pip install haveibeenpwnd


You can run tests with:

$ tox

Project details

Download files

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

Filename, size & hash SHA256 hash help File type Python version Upload date
haveibeenpwnd-0.2.2-py2.py3-none-any.whl (6.4 kB) Copy SHA256 hash SHA256 Wheel py2.py3

Supported by

Elastic Elastic Search Pingdom Pingdom Monitoring Google Google BigQuery Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN SignalFx SignalFx Supporter DigiCert DigiCert EV certificate StatusPage StatusPage Status page