Warning

This repository will no longer be accessible after 30th September 2026.

This project has been migrated to a consolidated monorepo. Please update your bookmarks, forks, and any CI/CD pipelines to point to the new location:

➡ https://github.com/lexisnexis-risk-solutions/emailage-public-clients/tree/main/Emailage_Go

No further updates will be made to this repository.

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.

The package no longer supports HMAC-SHA1, we recommend use of HMAC-SHA256, HMAC-SHA384, or HMAC-SHA512.

Getting Started

Requirements

git clone https://github.com/emailage/Emailage_Go.git

This package can be imported with:

go get https://github.com/emailage/Emailage_Go

Usage

Settings

Email Only Validation

params := map[string]string{
    "first_seen_days": 30,
    "phone": "8675309",
    "transorigin": "O",
}
res, err := client.EmailOnlyScore("nigerian.prince@legit.ru", params)
if err != nil {
    log.Fatalln(err)
}
fmt.Printf("Result: %+v\n", res.Query)

IP Only Validation

res, err := client.IPOnlyScore("192.168.0.1", nil)
if err != nil {
    log.Fatalln(err)
}
fmt.Printf("Result: %+v\n", res.Query)

Email and IP Validation

params := map[string]string{
    "billcity": "Phoenix",
    "responseCount": 10,
}
res, err := client.EmailAndIPScore("nigerian.prince@legit.ru", "192.168.0.1", params)
if err != nil {
    log.Fatalln(err)
}
fmt.Printf("Result: %+v\n", res.Query)