Skip to main content
Help us improve Python packaging – donate today!

Official Emailage API client written in Python

Project Description

alt text (

The Emailage™ API is organized around REST (Representational State Transfer). The API was built to help companies integrate with our highly efficient fraud risk and scoring system. By calling our API endpoints and simply passing us an email and/or IP Address, companies will be provided with real-time risk scoring assessments based around machine learning and proprietary algorithms that evolve with new fraud trends.

Getting Started


  • Python 2.7+ or 3.3+


Emailage can be installed with pip:

$ pip install emailage-official

or directly from the source code:

$ git clone
$ cd Emailage_Python
$ python install


Instantiate a client

from emailage.client import EmailageClient
# For a production server
emailage = EmailageClient('My account SID', 'My auth token')
# ... or for a sandbox
emailage = EmailageClient('My account SID', 'My auth token', sandbox=True)

Query risk score information for the provided email address, IP address, or a combination

# For an email address
# For an IP address
# For a combination. Please note the order
emailage.query(('', ''))
# Pass a User Defined Record ID (URID).
# Can be used when you want to add an identifier for a query.
# The identifier will be displayed in the result.
emailage.query('', urid='My record ID for')

Explicit methods produce the same request while validating format of the arguments passed

# For an email address
# For an IP address
# For a combination. Please note the order
emailage.query_email_and_ip_address('', '')
# Pass a User Defined Record ID
emailage.query_email_and_ip_address('', '', urid='My record ID for and')
Mark an email address as fraud, good, or neutral.
All the listed forms are possible.
When you mark something as fraud, don’t forget to pass a fraud code number from this list:
1 - Card Not Present Fraud
2 - Customer Dispute (Chargeback)
3 - First Party Fraud
4 - First Payment Default
5 - Identify Theft (Fraud Application)
6 - Identify Theft (Account Take Over)
7 - Suspected Fraud (Not Confirmed)
8 - Synthetic ID
9 - Other
# Mark an email address as fraud because of Synthetic ID.
emailage.flag('fraud', '', 8)
emailage.flag_as_fraud('', 8)
# Mark an email address as good.
emailage.flag('good', '')
# Unflag an email address that was previously marked as good or fraud.
emailage.flag('neutral', '')

Release history Release notifications

This version
History Node


History Node


History Node


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
emailage_official-1.0.2-py2.py3-none-any.whl (13.3 kB) Copy SHA256 hash SHA256 Wheel py2.py3 Nov 7, 2017

Supported by

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