SEON user docs logoSEON user docs logoSEON user docs logo
Search input icon

Email API v3

Our standalone Email API is designed to provide invaluable insights into the digital footprint associated with an email address, such as its email service provider, whether it is disposable, and the number of online profiles found when checking on more than 160 online platforms. It also returns all breaches associated with the email address and SEON's consortium fraud history built on our global intelligence for millions of onboarding events. It also returns a proprietary network score, which can be used as a new confidence indicator when assessing a user's digital profile. The risk score leverages machine learning alongside consortium data from over 5,000 global customers. Risk scores are derived from an anonymized model trained on historical data dating back 6 years, ensuring precise and accurate risk assessments.

Good to know

  • Use the Fraud API if you want to utilize SEON’s scoring engine for rule evaluation.
  • Use the Fraud API if you want to use the Email API together with any of our Phone API, IP API, and Device Fingerprinting.
  • All SEON API requests are case-sensitive - please follow the formatting below to avoid errors.
  • Email API requests are limited to 120/minute during your SEON free trial.
  • Consider using a higher, 4-5 seconds timeout setting for better data coverage.
  • Using the proprietary network scores and aggregated signals eliminates the need to manage and tune individual signals, which will free up resources. Additionally, future signals will be automatically added to this new version, requiring no additional development work.
  • The consortium-based threat intelligence pools data from diverse sectors and geographies for comprehensive threat detection. Consortium data from SEON’s proprietary network is available in two ways:
    • It is incorporated into the email and phone network risk scores;
    • There is a new section within the Email module called the SEON Fraud History where fraudulent transaction history is returned.
  • You can improve the accuracy of the network score by labeling data via the Label API or adjusting transaction states on the Admin Panel. Labels help the model learn from past fraudulent activities and update itself regularly for better accuracy.

Request

Add the following config parameters to the request for more control over the returned data.

Request Attributes

TypeRequired
email
stringyes
config
objectno

HTTP Endpoint

POST

https://api.seon.io/SeonRestService/email-api/v3
Python
Generic
Generic

Response

The endpoint returns a JSON-structured response.

Response Attributes

 Type
id
 string
email
 string
risk_scores
 object
email_details
 object
email_domain_details
 object
account_aggregates
 object
seon_fraud_history
 object
breach_details
 object
associated_domain_registrations
 object
Response
{
 "success": true,
 "error": {},
 "data": {
  "id": "67b0f0e5-42df-40d3-b744-5fb510d83cf2",
  "email": "johndoe@seon.io",
  "risk_scores": {
   "global_network_score": 11.26
  },
  "email_details": {
   "deliverable": true,
   "full_inbox": false,
   "valid_format": true,
   "minimum_age_months": 200,
   "earliest_profile_date": "2008-07-01 00:00:00"
  },
  "email_domain_details": {
   "accept_all": false,
   "created": "2015-03-20 12:42:37",
   "custom": true,
   "disposable": false,
   "dmarc_enforced": true,
   "domain": "seon.io",
   "expires": "2025-03-20 12:42:37",
   "free": false,
   "registered": true,
   "registered_to": "Seon Ltd.",
   "registrar_name": "NameCheap, Inc.",
   "spf_strict": true,
   "suspicious_tld": false,
   "tld": "io",
   "updated": "2024-02-24 08:11:02",
   "valid_mx": true,
   "website_exists": true
  },
  "account_aggregates": {
   "total_registration": 39,
   "business": {
    "total_registration": 14,
    "technology": {
     "registered": 11,
     "checked": 34
    },
    "science_and_education": {
     "registered": 2,
     "checked": 7
    },
    "jobs_and_employment": {
     "registered": 1,
     "checked": 4
    },
    "money_transfer_remittance": {
     "registered": 0,
     "checked": 2
    }
   },
   "personal": {
    "total_registration": 25,
    "email_service": {
     "registered": 2,
     "checked": 6
    },
    "technology": {
     "registered": 2,
     "checked": 7
    },
    "adult_sites": {
     "registered": 0,
     "checked": 2
    },
    "delivery": {
     "registered": 0,
     "checked": 2
    },
    "ecommerce": {
     "registered": 3,
     "checked": 16
    },
    "entertainment": {
     "registered": 7,
     "checked": 28
    },
    "health_and_fitness": {
     "registered": 2,
     "checked": 4
    },
    "social_media": {
     "registered": 8,
     "checked": 21
    },
    "travel": {
     "registered": 1,
     "checked": 7
    }
   }
  },
  "seon_fraud_history": {
   "fraudulent_decline_first_seen": 1625384237,
   "fraudulent_decline_last_seen": 1713949826,
   "fraudulent_decline_customer_hits": 2,
   "fraudulent_decline_hits": 2,
   "first_seen": 1584887689,
   "last_seen": 1713949826,
   "customer_hits": 4,
   "hits": 9,
   "flags": []
  },
  "breach_details": {
   "breaches": [
    {
     "date": "2018-07-23",
     "domain": "apollo.io",
     "name": "Apollo"
    },
    {
     "date": "2019-05-24",
     "domain": "canva.com",
     "name": "Canva"
    },
    {
     "date": "2020-09-28",
     "domain": "gonitro.com",
     "name": "Nitro"
    },
    {
     "date": "2021-08-01",
     "domain": "opensubtitles.org",
     "name": "Open Subtitles"
    },
    {
     "date": "2018-12-13",
     "domain": "wanelo.com",
     "name": "Wanelo"
    }
   ],
   "first_breach": "2018-07-23",
   "haveibeenpwned_listed": true,
   "number_of_breaches": 5
  },
  "associated_domain_registrations": {
   "exists": true,
   "number_of_domains": 1,
   "domains": [
    {
     "domain_name": "thisisasampledomain.com",
     "create_date": "2015-08-07 00:00:00",
     "update_date": "2015-08-07 00:00:00",
     "expiry_date": "2016-08-07 00:00:00",
     "registrar_name": "GoDaddy.com, LLC",
     "full_name": "John Doe",
     "company_name": "JD Enterprises Ltd",
     "mailing_address": "472, Doejohn Street",
     "city_name": "JD City",
     "state_name": "N/A",
     "zip_code": "JD1234",
     "country_code": "JD",
     "phone_number": "1234556789"
    }
   ],
   "first_registration_date": "2015-08-07 00:00:00"
  }
 }
}

Fraud API Integration

To enable Advanced Digital Footprint, configure the newest Email API (v3) and Phone API (v2) versions under Fraud API config.

Do you have any questions?

Contact us