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

Email API

Our standalone Email API is designed to provide you with invaluable insights into the digital footprint associated with an email address, such as the approximate minimum age, its provider, and whether it is disposable, and also returns all breaches associated with the email address and any linked online profiles.

Good to know

  • 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.
  • For in-depth fraud investigations, or situations where additional profile information is necessary and a higher timeout setting can be accommodated, use detailed Data Enrichment Mode. More information can be found below under Request Attributes.

Request

The [email_address] in the request URI should include the full email address, for example: example@example.com

 

Optional query string parameters

Add the following parameters to the request URL for more control over the returned data, as seen in the example URL below.

GET

https://api.seon.io/SeonRestService/email-api/v2/[email_address]?include=history,flags,id&flags_timeframe_days=10&timeout=5000

Request Attributes

TypeRequired
version
stringyes
include
stringno
flags_timeframe_days
integerno
timeout
integerno
priority_timeout
integerno
priority_sites
stringno
priority_accuracy
numberno
data_enrichment_mode
stringno

 

HTTP Endpoint

GET

https://api.seon.io/SeonRestService/email-api/v2/[email_address]
PHP
Generic
Generic

Response

The endpoint returns JSON structured response.

JSON Attributes

Type
email
string
score
number
deliverable
boolean
domain_details
object
account_details
object
breach_details
object
applied_rules
array of object
history
object
flags
array of object
id
string
Response
{
 "success": true,
 "error": {},
 "data": {
  "email": "test2023-10-30ev2@gmail.com",
  "score": 11,
  "deliverable": false,
  "domain_details": {
   "domain": "gmail.com",
   "tld": ".com",
   "registered": true,
   "created": "1995-08-13 04:00:00",
   "updated": "2023-07-11 10:10:13",
   "expires": "2024-08-12 04:00:00",
   "registrar_name": "MarkMonitor Inc.",
   "registered_to": "Google LLC",
   "disposable": false,
   "free": true,
   "custom": false,
   "dmarc_enforced": true,
   "spf_strict": true,
   "valid_mx": true,
   "accept_all": false,
   "suspicious_tld": false,
   "website_exists": true
  },
  "account_details": {
   "apple": {
    "registered": false
   },
   "ebay": {
    "registered": false
   },
   "facebook": {
    "registered": false,
    "url": null,
    "name": null,
    "photo": null
   },
   "flickr": {
    "registered": false,
    "username": null,
    "photo": null,
    "followers": null,
    "location": null,
    "occupation": null,
    "description": null
   },
   "foursquare": {
    "registered": null,
    "bio": null,
    "photo": null,
    "profile_url": null
   },
   "github": {
    "registered": false,
    "photo": null,
    "full_name": null,
    "username": null,
    "location": null,
    "company": null,
    "website": null,
    "bio": null,
    "followers": null,
    "following": null,
    "twitter": null,
    "profile_url": null
   },
   "google": {
    "registered": false,
    "photo": null,
    "activity": {
     "reviews": null,
     "ratings": null,
     "photos": null,
     "videos": null,
     "answers": null,
     "edits": null,
     "places_added": null,
     "roads_added": null,
     "facts_checked": null,
     "published_lists": null,
     "q_and_a": null
    },
    "is_enterprise_user": null,
    "last_updated": null
   },
   "gravatar": {
    "registered": false,
    "location": null,
    "name": null,
    "profile_url": null,
    "username": null
   },
   "instagram": {
    "registered": false
   },
   "lastfm": {
    "registered": null
   },
   "linkedin": {
    "registered": null,
    "url": null,
    "name": null,
    "company": null,
    "title": null,
    "location": null,
    "website": null,
    "twitter": null,
    "photo": null,
    "connection_count": null
   },
   "microsoft": {
    "registered": false
   },
   "myspace": {
    "registered": false
   },
   "pinterest": {
    "registered": false
   },
   "skype": {
    "registered": false,
    "country": null,
    "country_code": null,
    "city": null,
    "gender": null,
    "name": null,
    "id": null,
    "handle": null,
    "bio": null,
    "age": null,
    "language": null,
    "state": null,
    "photo": null,
    "contact_type": null
   },
   "spotify": {
    "registered": false
   },
   "tumblr": {
    "registered": false
   },
   "twitter": {
    "registered": false
   },
   "vimeo": {
    "registered": false
   },
   "weibo": {
    "registered": false
   },
   "yahoo": {
    "registered": false
   },
   "discord": {
    "registered": false
   },
   "ok": {
    "registered": false,
    "city": null,
    "age": null,
    "date_joined": null,
    "full_name": null
   },
   "kakao": {
    "registered": null
   },
   "booking": {
    "registered": false
   },
   "airbnb": {
    "registered": null,
    "about": null,
    "created_at": null,
    "first_name": null,
    "identity_verified": null,
    "location": null,
    "image": null,
    "reviewee_count": null,
    "trips": null,
    "work": null
   },
   "amazon": {
    "registered": null
   },
   "qzone": {
    "registered": false
   },
   "adobe": {
    "registered": false
   },
   "mailru": {
    "registered": false
   },
   "wordpress": {
    "registered": false
   },
   "imgur": {
    "registered": false
   },
   "disneyplus": {
    "registered": false
   },
   "netflix": {
    "registered": false
   },
   "jdid": {
    "registered": null
   },
   "flipkart": {
    "registered": false
   },
   "bukalapak": {
    "registered": false
   },
   "archiveorg": {
    "registered": false
   },
   "lazada": {
    "registered": false
   },
   "zoho": {
    "registered": false
   },
   "samsung": {
    "registered": false
   },
   "evernote": {
    "registered": false
   },
   "envato": {
    "registered": false
   },
   "patreon": {
    "registered": false
   },
   "tokopedia": {
    "registered": false
   },
   "rambler": {
    "registered": false
   },
   "quora": {
    "registered": false
   },
   "atlassian": {
    "registered": false
   },
   "aboutme": {
    "registered": false
   },
   "altbalaji": {
    "registered": false
   },
   "bitmoji": {
    "registered": false
   },
   "bodybuilding": {
    "registered": false
   },
   "codecademy": {
    "registered": false
   },
   "deliveroo": {
    "registered": false
   },
   "diigo": {
    "registered": false
   },
   "duolingo": {
    "registered": false,
    "full_name": null,
    "photo": null,
    "registered_at": null,
    "country": null,
    "username": null,
    "has_recent_activity": null,
    "learning_language": null,
    "from_language": null,
    "email_verified": null,
    "courses": null
   },
   "eventbrite": {
    "registered": false
   },
   "firefox": {
    "registered": false
   },
   "freelancer": {
    "registered": false
   },
   "gaana": {
    "registered": false
   },
   "giphy": {
    "registered": false
   },
   "hubspot": {
    "registered": false
   },
   "kommo": {
    "registered": false
   },
   "komoot": {
    "registered": false
   },
   "nike": {
    "registered": false
   },
   "plurk": {
    "registered": false
   },
   "rappi": {
    "registered": false
   },
   "replit": {
    "registered": false
   },
   "seoclerks": {
    "registered": false
   },
   "snapchat": {
    "registered": false
   },
   "snapdeal": {
    "registered": null
   },
   "soundcloud": {
    "registered": false
   },
   "starz": {
    "registered": false
   },
   "strava": {
    "registered": false
   },
   "taringa": {
    "registered": false,
    "username": null,
    "photo": null
   },
   "tiki": {
    "registered": false
   },
   "treehouse": {
    "registered": false
   },
   "venmo": {
    "registered": false
   },
   "vivino": {
    "registered": false
   },
   "vkontakte": {
    "registered": false
   },
   "wattpad": {
    "registered": false
   },
   "xing": {
    "registered": false
   },
   "yandex": {
    "registered": false
   },
   "adult_sites": {
    "registered": false
   }
  },
  "breach_details": {
   "haveibeenpwned_listed": false,
   "number_of_breaches": 0,
   "first_breach": null,
   "breaches": []
  },
  "applied_rules": [
   {
    "id": "E114",
    "name": "Domain is a free provider. No online profiles were found. It was not involved in a data breach",
    "operation": "+",
    "score": 10
   },
   {
    "id": "E122",
    "name": "5 or more digits in email handle or in username",
    "operation": "+",
    "score": 1
   }
  ],
  "id": "3de42a30-9603-4316-aae2-12ad9894fb21",
  "history": {
   "hits": 2,
   "customer_hits": 1,
   "first_seen": 1698669982,
   "last_seen": 1698669982
  },
  "flags": []
 }
}