{
    "info": {
        "author": "MailboxValidator.com",
        "author_email": "support@mailboxvalidator.com",
        "bugtrack_url": null,
        "classifiers": [
            "Development Status :: 5 - Production/Stable",
            "Intended Audience :: Developers",
            "License :: OSI Approved :: MIT License",
            "Operating System :: OS Independent",
            "Programming Language :: Python :: 3",
            "Topic :: Software Development :: Libraries :: Python Modules"
        ],
        "description": "MailboxValidator Python Module\n==============================\n\nThis Python module provides an easy way to call the MailboxValidator API which validates if an email address is a valid one.\n\nThis module can be used in many types of projects such as:\n\n - validating a user's email during sign up\n - cleaning your mailing list prior to an email marketing campaign\n - a form of fraud check\n\n\nInstallation\n============\n\nTo install this module type the following:\n\n\tpip install MailboxValidator\n\n\nDependencies\n============\n\nAn API key is required for this module to function.\n\nGo to https://www.mailboxvalidator.com/plans#api to sign up for FREE API plan and you'll be given an API key.\n\n\nUsage for validating emails\n===========================\n\n```python\nimport MailboxValidator\n\n\tmbv = MailboxValidator.SingleValidation('PASTE_API_KEY_HERE')\n\tresults = mbv.ValidateEmail('example@example.com')\n\n\tif results is None:\n\t\tprint(\"Error connecting to API.\\n\")\n\telif results['error_code'] == '':\n\t\tprint('email_address = ' + results['email_address'] + \"\\n\")\n\t\tprint('domain = ' + results['domain'] + \"\\n\")\n\t\tprint('is_free = ' + results['is_free'] + \"\\n\")\n\t\tprint('is_syntax = ' + results['is_syntax'] + \"\\n\")\n\t\tprint('is_domain = ' + results['is_domain'] + \"\\n\")\n\t\tprint('is_smtp = ' + results['is_smtp'] + \"\\n\")\n\t\tprint('is_verified = ' + results['is_verified'] + \"\\n\")\n\t\tprint('is_server_down = ' + results['is_server_down'] + \"\\n\")\n\t\tprint('is_greylisted = ' + results['is_greylisted'] + \"\\n\")\n\t\tprint('is_disposable = ' + results['is_disposable'] + \"\\n\")\n\t\tprint('is_suppressed = ' + results['is_suppressed'] + \"\\n\")\n\t\tprint('is_role = ' + results['is_role'] + \"\\n\")\n\t\tprint('is_high_risk = ' + results['is_high_risk'] + \"\\n\")\n\t\tprint('is_catchall = ' + results['is_catchall'] + \"\\n\")\n\t\tprint('mailboxvalidator_score = ' + str(results['mailboxvalidator_score']) + \"\\n\")\n\t\tprint('time_taken = ' + str(results['time_taken']) + \"\\n\")\n\t\tprint('status = ' + results['status'] + \"\\n\")\n\t\tprint('credits_available = ' + str(results['credits_available']) + \"\\n\")\n\telse:\n\t\tprint('error_code = ' + results['error_code'] + \"\\n\")\n\t\tprint('error_message = ' + results['error_message'] + \"\\n\")\n```\n\nFunctions\n=========\n\n### SingleValidation(api_key)\n\nCreates a new instance of the MailboxValidator object with the API key.\n\n### ValidateEmail(email_address)\n\nPerforms email validation on the supplied email address.\n\nResult Fields\n=============\n\n### email_address\n\nThe input email address.\n\n### domain\n\nThe domain of the email address.\n\n### is_free\n\nWhether the email address is from a free email provider like Gmail or Hotmail.\n\nReturn values: True, False\n\n### is_syntax\n\nWhether the email address is syntactically correct.\n\nReturn values: True, False\n\n### is_domain\n\nWhether the email address has a valid MX record in its DNS entries.\n\nReturn values: True, False, -&nbsp;&nbsp;&nbsp;(- means not applicable)\n\n### is_smtp\n\nWhether the mail servers specified in the MX records are responding to connections.\n\nReturn values: True, False, -&nbsp;&nbsp;&nbsp;(- means not applicable)\n\n### is_verified\n\nWhether the mail server confirms that the email address actually exist.\n\nReturn values: True, False, -&nbsp;&nbsp;&nbsp;(- means not applicable)\n\n### is_server_down\n\nWhether the mail server is currently down or unresponsive.\n\nReturn values: True, False, -&nbsp;&nbsp;&nbsp;(- means not applicable)\n\n### is_greylisted\n\nWhether the mail server employs greylisting where an email has to be sent a second time at a later time.\n\nReturn values: True, False, -&nbsp;&nbsp;&nbsp;(- means not applicable)\n\n### is_disposable\n\nWhether the email address is a temporary one from a disposable email provider.\n\nReturn values: True, False, -&nbsp;&nbsp;&nbsp;(- means not applicable)\n\n### is_suppressed\n\nWhether the email address is in our blacklist.\n\nReturn values: True, False, -&nbsp;&nbsp;&nbsp;(- means not applicable)\n\n### is_role\n\nWhether the email address is a role-based email address like admin@example.net or webmaster@example.net.\n\nReturn values: True, False, -&nbsp;&nbsp;&nbsp;(- means not applicable)\n\n### is_high_risk\n\nWhether the email address contains high risk keywords.\n\nReturn values: True, False, -&nbsp;&nbsp;&nbsp;(- means not applicable)\n\n### is_catchall\n\nWhether the email address is a catch-all address.\n\nReturn values: True, False, Unknown, -&nbsp;&nbsp;&nbsp;(- means not applicable)\n\n### mailboxvalidator_score\n\nEmail address reputation score.\n\nScore > 0.70 means good; score > 0.40 means fair; score <= 0.40 means poor.\n\n### time_taken\n\nThe time taken to get the results in seconds.\n\n### status\n\nWhether our system think the email address is valid based on all the previous fields.\n\nReturn values: True, False\n\n### credits_available\n\nThe number of credits left to perform validations.\n\n### error_code\n\nThe error code if there is any error. See error table below.\n\n### error_message\n\nThe error message if there is any error. See error table below.\n\n\nUsage for checking if an email is from a disposable email provider\n===================================================================\n\n```python\nimport MailboxValidator\n\n\tmbv = MailboxValidator.SingleValidation('PASTE_API_KEY_HERE')\n\tresults = mbv.DisposableEmail('example@example.com')\n\n\tif results is None:\n\t\tprint(\"Error connecting to API.\\n\")\n\telif results['error_code'] == '':\n\t\tprint('email_address = ' + results['email_address'] + \"\\n\")\n\t\tprint('is_disposable = ' + results['is_disposable'] + \"\\n\")\n\t\tprint('credits_available = ' + str(results['credits_available']) + \"\\n\")\n\telse:\n\t\tprint('error_code = ' + results['error_code'] + \"\\n\")\n\t\tprint('error_message = ' + results['error_message'] + \"\\n\")\n```\n\nFunctions\n=========\n\n### SingleValidation(api_key)\n\nCreates a new instance of the MailboxValidator object with the API key.\n\n### DisposableEmail(email_address)\n\nCheck if the supplied email address is from a disposable email provider.\n\nResult Fields\n=============\n\n### email_address\n\nThe input email address.\n\n### is_disposable\n\nWhether the email address is a temporary one from a disposable email provider.\n\nReturn values: True, False\n\n### credits_available\n\nThe number of credits left to perform validations.\n\n### error_code\n\nThe error code if there is any error. See error table below.\n\n### error_message\n\nThe error message if there is any error. See error table below.\n\n\nUsage for checking if an email is from a free email provider\n============================================================\n\n```python\nimport MailboxValidator\n\n\tmbv = MailboxValidator.SingleValidation('PASTE_API_KEY_HERE')\n\tresults = mbv.FreeEmail('example@example.com')\n\n\tif results is None:\n\t\tprint(\"Error connecting to API.\\n\")\n\telif results['error_code'] == '':\n\t\tprint('email_address = ' + results['email_address'] + \"\\n\")\n\t\tprint('is_free = ' + results['is_free'] + \"\\n\")\n\t\tprint('credits_available = ' + str(results['credits_available']) + \"\\n\")\n\telse:\n\t\tprint('error_code = ' + results['error_code'] + \"\\n\")\n\t\tprint('error_message = ' + results['error_message'] + \"\\n\")\n```\n\nFunctions\n=========\n\n### SingleValidation(api_key)\n\nCreates a new instance of the MailboxValidator object with the API key.\n\n### FreeEmail(email_address)\n\nCheck if the supplied email address is from a free email provider.\n\nResult Fields\n=============\n\n### email_address\n\nThe input email address.\n\n### is_free\n\nWhether the email address is from a free email provider like Gmail or Hotmail.\n\nReturn values: True, False\n\n### credits_available\n\nThe number of credits left to perform validations.\n\n### error_code\n\nThe error code if there is any error. See error table below.\n\n### error_message\n\nThe error message if there is any error. See error table below.\n\n\nErrors\n======\n\n| error_code | error_message |\n| ---------- | ------------- |\n| 100 | Missing parameter. |\n| 101 | API key not found. |\n| 102 | API key disabled. |\n| 103 | API key expired. |\n| 104 | Insufficient credits. |\n| 105 | Unknown error. |\n\nCopyright\n=========\n\nCopyright (C) 2018 by MailboxValidator.com, support@mailboxvalidator.com\n\n\n",
        "description_content_type": "text/markdown",
        "docs_url": null,
        "download_url": "",
        "downloads": {
            "last_day": -1,
            "last_month": -1,
            "last_week": -1
        },
        "home_page": "https://github.com/MailboxValidator/mailboxvalidator-python",
        "keywords": "",
        "license": "",
        "maintainer": "",
        "maintainer_email": "",
        "name": "MailboxValidator",
        "package_url": "https://pypi.org/project/MailboxValidator/",
        "platform": "",
        "project_url": "https://pypi.org/project/MailboxValidator/",
        "project_urls": {
            "Homepage": "https://github.com/MailboxValidator/mailboxvalidator-python"
        },
        "release_url": "https://pypi.org/project/MailboxValidator/1.1.0/",
        "requires_dist": null,
        "requires_python": "",
        "summary": "Email verification module for Python using MailboxValidator API. It validates if the email is valid, from a free provider, contains high-risk keywords, whether it's a catch-all address and so much more.",
        "version": "1.1.0"
    },
    "last_serial": 4310852,
    "releases": {
        "1.0.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "0907acefe289c5af129a0a16f19fde4c",
                    "sha256": "206792844b9df8060383a04a19981cff9902ee61b2e62f236f98e17b49e76eb5"
                },
                "downloads": -1,
                "filename": "MailboxValidator-1.0.0-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "0907acefe289c5af129a0a16f19fde4c",
                "packagetype": "bdist_wheel",
                "python_version": "py2.py3",
                "requires_python": null,
                "size": 2267,
                "upload_time": "2017-07-17T01:32:01",
                "url": "https://files.pythonhosted.org/packages/2c/20/43135cc39194856d9e28a207c6bdabcde227cd0cbc99252f3e6506ba256d/MailboxValidator-1.0.0-py2.py3-none-any.whl"
            }
        ],
        "1.0.1": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "32ab6de8b0853f8fde8159d5b651f06b",
                    "sha256": "47541cdbafe329445aacaa14a5d2df1e4722501b1540ce275f7ad982c15accea"
                },
                "downloads": -1,
                "filename": "MailboxValidator-1.0.1-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "32ab6de8b0853f8fde8159d5b651f06b",
                "packagetype": "bdist_wheel",
                "python_version": "py2.py3",
                "requires_python": null,
                "size": 2255,
                "upload_time": "2017-07-17T01:35:58",
                "url": "https://files.pythonhosted.org/packages/29/5a/e2c2ff3ff835c2020b9e7f2313f164df276bff2d5f8c5ccda95135478c0f/MailboxValidator-1.0.1-py2.py3-none-any.whl"
            }
        ],
        "1.0.10": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "b68a88e228e9a6dbd80a1b7d5cc79125",
                    "sha256": "cd5a60864355667fd5a209a06637f75e95a03d050e8ae6107bac38afe6328e9c"
                },
                "downloads": -1,
                "filename": "MailboxValidator-1.0.10-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "b68a88e228e9a6dbd80a1b7d5cc79125",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 2058,
                "upload_time": "2018-07-09T07:28:41",
                "url": "https://files.pythonhosted.org/packages/92/c9/6214ac2169507d767b75de2a456679f3ea6f71ef82c31193e0827f3f54a5/MailboxValidator-1.0.10-py3-none-any.whl"
            }
        ],
        "1.0.11": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "2af9dbd5185db557460d748f5ea26d6c",
                    "sha256": "6321d5974da95338e8d7cceb723c1e22bfea790be08eb42f89366c7ea2b168c3"
                },
                "downloads": -1,
                "filename": "MailboxValidator-1.0.11-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "2af9dbd5185db557460d748f5ea26d6c",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 2059,
                "upload_time": "2018-07-09T08:03:15",
                "url": "https://files.pythonhosted.org/packages/2b/dd/3c18db825360f27752eb599fe8c55340bc7ff0bc0c40b064d6421ddb511e/MailboxValidator-1.0.11-py3-none-any.whl"
            }
        ],
        "1.0.12": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "2c3c4d725d9df5a9a90f54dec89c7b45",
                    "sha256": "63da0110d8b1590bf56acc9887eaf7ba37855eaceb183a1b91dc2b9e7e430921"
                },
                "downloads": -1,
                "filename": "MailboxValidator-1.0.12-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "2c3c4d725d9df5a9a90f54dec89c7b45",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 2061,
                "upload_time": "2018-07-09T08:27:18",
                "url": "https://files.pythonhosted.org/packages/07/ed/9dbd436f967e1feb9b33516792c080ea5d328eaddf996328a706206557f4/MailboxValidator-1.0.12-py3-none-any.whl"
            }
        ],
        "1.0.13": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "e74ab6da75fff69110006f52c1e2b24a",
                    "sha256": "316fa1c887857fdeb103fdba207e2e9488037dd2c44c044013422633a55c8bdc"
                },
                "downloads": -1,
                "filename": "MailboxValidator-1.0.13-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "e74ab6da75fff69110006f52c1e2b24a",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 3677,
                "upload_time": "2018-07-09T08:56:20",
                "url": "https://files.pythonhosted.org/packages/da/a3/bcaf41fd13a46d41d3ccc00050888e0ed6b1fa7aeed1112f65bf67a911dd/MailboxValidator-1.0.13-py3-none-any.whl"
            }
        ],
        "1.0.2": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "80a00ff9708dd1a4c7cb7a777328db6c",
                    "sha256": "b99c914e2c4692ffc8d24f50deffc672c5caea3b238dd467a5ef509a342fb578"
                },
                "downloads": -1,
                "filename": "MailboxValidator-1.0.2-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "80a00ff9708dd1a4c7cb7a777328db6c",
                "packagetype": "bdist_wheel",
                "python_version": "py2.py3",
                "requires_python": null,
                "size": 2217,
                "upload_time": "2017-07-17T01:37:59",
                "url": "https://files.pythonhosted.org/packages/e9/7e/c13f0cc4d6ca2788fe60b0fab95d61fd872df49db026bfc088b85d09602b/MailboxValidator-1.0.2-py2.py3-none-any.whl"
            }
        ],
        "1.0.3": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "7211efc641f8fcf7d08550e94f7548ae",
                    "sha256": "7facb106f4c7e34e1186b24837460203825088f85b6eccf4821c826fbdc4afe4"
                },
                "downloads": -1,
                "filename": "MailboxValidator-1.0.3-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "7211efc641f8fcf7d08550e94f7548ae",
                "packagetype": "bdist_wheel",
                "python_version": "py2.py3",
                "requires_python": null,
                "size": 2916,
                "upload_time": "2017-07-17T01:45:58",
                "url": "https://files.pythonhosted.org/packages/65/8d/0dacf84d33c3537835c080331fa76499849e5cd2c2e0ee8c840b2f75c7eb/MailboxValidator-1.0.3-py2.py3-none-any.whl"
            }
        ],
        "1.0.4": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "9773f561f7ef33d1b5cfbf7ee2348211",
                    "sha256": "17faafb8e585e7299fdf0078aef868a0c7f3078175f5d70a5e8cce093f329eec"
                },
                "downloads": -1,
                "filename": "MailboxValidator-1.0.4-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "9773f561f7ef33d1b5cfbf7ee2348211",
                "packagetype": "bdist_wheel",
                "python_version": "py2.py3",
                "requires_python": null,
                "size": 2948,
                "upload_time": "2017-07-17T01:55:46",
                "url": "https://files.pythonhosted.org/packages/70/f1/8352dcc6b7c0884995a0b37f7dd1caf79d359d0fa6b0e7afcb6b276dc9c4/MailboxValidator-1.0.4-py2.py3-none-any.whl"
            }
        ],
        "1.0.5": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "6c52cdfca2efe7d6f5a17d369ab1cc2e",
                    "sha256": "f07e5970753f0aebd10b4507a206a966cc81cd784b21850b6c2bcc7673954389"
                },
                "downloads": -1,
                "filename": "MailboxValidator-1.0.5-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "6c52cdfca2efe7d6f5a17d369ab1cc2e",
                "packagetype": "bdist_wheel",
                "python_version": "py2.py3",
                "requires_python": null,
                "size": 2961,
                "upload_time": "2017-07-17T02:17:38",
                "url": "https://files.pythonhosted.org/packages/84/3a/eb665e6d8daf537aba676d4200665e625bed1db88c694b614ac6e7cf969b/MailboxValidator-1.0.5-py2.py3-none-any.whl"
            }
        ],
        "1.0.6": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "bf2856787593adc244775922861ddbf7",
                    "sha256": "eb3b006facbdb45862a7fcdedee7b28c784d0dd8ce0b3109bda1d366598a2da3"
                },
                "downloads": -1,
                "filename": "MailboxValidator-1.0.6-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "bf2856787593adc244775922861ddbf7",
                "packagetype": "bdist_wheel",
                "python_version": "py2.py3",
                "requires_python": null,
                "size": 2965,
                "upload_time": "2017-07-17T02:24:40",
                "url": "https://files.pythonhosted.org/packages/49/fb/223afab0fc89eb9fa34c84a1799358211c24633073a2654562fa7be568e5/MailboxValidator-1.0.6-py2.py3-none-any.whl"
            }
        ],
        "1.0.7": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "7778b7c54bb9c0bf85b1bb246665abd5",
                    "sha256": "af10f5d5e614752d12f040e7c97826f64ce3c36f168c5991758a185e39ff01c4"
                },
                "downloads": -1,
                "filename": "MailboxValidator-1.0.7-py2.py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "7778b7c54bb9c0bf85b1bb246665abd5",
                "packagetype": "bdist_wheel",
                "python_version": "py2.py3",
                "requires_python": null,
                "size": 2971,
                "upload_time": "2017-07-17T02:37:31",
                "url": "https://files.pythonhosted.org/packages/84/b7/58af830d3b98e921c56f19526959ef8a0bcc4b421d095e20396fead05b60/MailboxValidator-1.0.7-py2.py3-none-any.whl"
            }
        ],
        "1.0.8": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "b0bbf7e0e21894a7daded22a3decc389",
                    "sha256": "3eb4398c09224fb4aa41fa6e0ef09f582a4f4282b853eb4bb930d3dadd5799ee"
                },
                "downloads": -1,
                "filename": "MailboxValidator-1.0.8-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "b0bbf7e0e21894a7daded22a3decc389",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 2968,
                "upload_time": "2017-07-17T02:54:22",
                "url": "https://files.pythonhosted.org/packages/2f/84/63df03e13dfd68246f06e00d8f5b97e5a205218fcc8605af654be5c1d2a0/MailboxValidator-1.0.8-py3-none-any.whl"
            }
        ],
        "1.0.9": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "1c66bdb740bad3fd1a627ba38ca7cb9c",
                    "sha256": "54cebe28d3e066c28d7e1fd1a359f1f2a01f9556ed47bfb5883bdc77495aac72"
                },
                "downloads": -1,
                "filename": "MailboxValidator-1.0.9-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "1c66bdb740bad3fd1a627ba38ca7cb9c",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 2049,
                "upload_time": "2018-07-09T07:11:42",
                "url": "https://files.pythonhosted.org/packages/88/95/2b6648f5326cb9b96f4ac096cbb9a00aafd6d0e4034e255fddab4f4fc7c6/MailboxValidator-1.0.9-py3-none-any.whl"
            }
        ],
        "1.1.0": [
            {
                "comment_text": "",
                "digests": {
                    "md5": "dd7f97a26d5b7b66059058e20eb59783",
                    "sha256": "61679f43913da1f97a3cf8babb84f3f9524b6621bdd2db76911ac544e6a4ac07"
                },
                "downloads": -1,
                "filename": "MailboxValidator-1.1.0-py3-none-any.whl",
                "has_sig": false,
                "md5_digest": "dd7f97a26d5b7b66059058e20eb59783",
                "packagetype": "bdist_wheel",
                "python_version": "py3",
                "requires_python": null,
                "size": 3832,
                "upload_time": "2018-09-26T02:16:50",
                "url": "https://files.pythonhosted.org/packages/19/1c/cb6d111437dc132919b2c8c548ebe1f7cdf1df7fff2ad0387d125ae0e4b6/MailboxValidator-1.1.0-py3-none-any.whl"
            }
        ]
    },
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "dd7f97a26d5b7b66059058e20eb59783",
                "sha256": "61679f43913da1f97a3cf8babb84f3f9524b6621bdd2db76911ac544e6a4ac07"
            },
            "downloads": -1,
            "filename": "MailboxValidator-1.1.0-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "dd7f97a26d5b7b66059058e20eb59783",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": null,
            "size": 3832,
            "upload_time": "2018-09-26T02:16:50",
            "url": "https://files.pythonhosted.org/packages/19/1c/cb6d111437dc132919b2c8c548ebe1f7cdf1df7fff2ad0387d125ae0e4b6/MailboxValidator-1.1.0-py3-none-any.whl"
        }
    ]
}