---
agentTools:
projectIndex: https://docs.defastra.com/llms.txt
---
# Deep Email Check
Risk scoring with real-time data enrichment for email addresses.
For more details about the social & digital data we return, read our up-to-date data list.
# OpenAPI definition
````json
{
"openapi": "3.1.0",
"info": {
"title": "Fraud Prevention Endpoints",
"version": "1.0"
},
"servers": [
{
"url": "https://api.defastra.com"
}
],
"tags": [
{
"name": "For Email Addresses"
}
],
"components": {
"securitySchemes": {
"sec0": {
"type": "apiKey",
"in": "header",
"name": "X-API-KEY",
"x-default": ""
}
}
},
"security": [
{
"sec0": []
}
],
"paths": {
"/deep_email_check": {
"post": {
"tags": [
"For Email Addresses"
],
"summary": "Deep Email Check",
"description": "Risk scoring with real-time data enrichment for email addresses.
For more details about the social & digital data we return, read our up-to-date data list.
",
"operationId": "deep-email-check",
"requestBody": {
"content": {
"application/x-www-form-urlencoded": {
"schema": {
"type": "object",
"required": [
"email"
],
"properties": {
"email": {
"type": "string",
"example": "example@gmail.com",
"description": "The email address you want to check"
},
"timeout": {
"type": "string",
"enum": [
"minimal",
"normal",
"extensive"
],
"default": "normal",
"example": "extensive",
"description": "The timeout parameters allows you to control the response time of the check, allowing you to choose between more detailed results and faster response times. Please read this guide."
},
"label": {
"type": "string",
"example": "TEST #45",
"description": "A label is any string of text (max. 100 char) that can be attributed to any lookup. They are useful for organizing your data and can be used to search for data in the Observer, or visualize them on the dashboard."
}
}
}
}
}
},
"responses": {
"200": {
"description": "Your request was successful. The response contains a JSON object with our risk analysis & data enrichment. A full real-life example can be seen in the column to the far right.\n\n**Click here to expand the full details**.",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\"status\":true,\"request_id\":\"82960F388560A218E29104A2A8C3F29A\",\"deep_email_check\":{\"risk_level\":\"extreme\",\"risk_score\":88,\"email\":\"example@gmail.com\",\"profiles_count\":85,\"creation_date\":{\"datetime\":\"2008-07-01\",\"timestamp\":1214870400},\"deliverability\":\"invalid\",\"signals\":[{\"result_type\":\"risk\",\"detail\":\"The countries linked to this email (\\\"RU\\\" on askfm, \\\"SA\\\" on skype, \\\"TR\\\" on foursquare) don't match between themselves.\",\"name\":\"EMAIL_POSITION_CONSISTENCY\"},{\"result_type\":\"risk\",\"detail\":\"This email address is undeliverable and has an 'invalid' status\",\"name\":\"EMAIL_DELIVERABILITY\"},{\"result_type\":\"risk\",\"detail\":\"This email address is linked to 85 online profiles which indicates this email is shared\",\"name\":\"EMAIL_ONLINE_VELOCITY\"},{\"result_type\":\"risk\",\"detail\":\"This email address is present in much more data breach than usual, indicating a shared email\",\"name\":\"EMAIL_DATA_BREACH\"}],\"online_profiles\":{\"amazon\":{\"error\":false,\"is_registered\":false},\"nike\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"first_name\":null,\"last_name\":null,\"picture_base64\":null,\"picture_last_modified\":null,\"username\":null}},\"instagram\":{\"error\":false,\"is_registered\":false},\"google\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"country\":null,\"country_code\":null,\"gender\":null,\"google_maps_profile\":null,\"in_app_notification\":null,\"last_update\":{\"datetime\":null,\"timestamp\":null},\"name\":null,\"picture_base64\":null,\"profile_url\":null}},\"foursquare\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"bio\":null,\"city\":null,\"country\":null,\"country_code\":null,\"facebook_url\":null,\"first_name\":null,\"friends_count\":null,\"gender\":null,\"last_name\":null,\"picture_base64\":null,\"profile_url\":null,\"twitter_url\":null,\"username\":null}},\"badoo\":{\"error\":false,\"is_registered\":false},\"battlenet\":{\"error\":false,\"is_registered\":false},\"microsoft\":{\"error\":false,\"is_registered\":false},\"skype\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"birthday\":null,\"city\":null,\"country\":null,\"country_code\":null,\"gender\":null,\"name\":null,\"picture_base64\":null,\"skype_id\":null}},\"atlassian\":{\"error\":false,\"is_registered\":false},\"twitter\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"multiple_accounts\":null}},\"uber\":{\"error\":false,\"is_registered\":false},\"asus\":{\"error\":false,\"is_registered\":false},\"github\":{\"error\":false,\"is_registered\":false},\"indeed\":{\"error\":false,\"is_registered\":false},\"tumblr\":{\"error\":false,\"is_registered\":false},\"vimeo\":{\"error\":false,\"is_registered\":false},\"myspace\":{\"error\":false,\"is_registered\":false},\"bitly\":{\"error\":false,\"is_registered\":false},\"booking\":{\"error\":true},\"snapchat\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"has_bitmoji\":null}},\"bukalapak\":{\"error\":false,\"is_registered\":false},\"care2\":{\"error\":false,\"is_registered\":false},\"change\":{\"error\":false,\"is_registered\":false},\"kakaotalk\":{\"error\":false,\"is_registered\":false},\"hubspot\":{\"error\":false,\"is_registered\":false},\"vrbo\":{\"error\":false,\"is_registered\":false},\"tiktok\":{\"error\":false,\"is_registered\":false},\"patreon\":{\"error\":false,\"is_registered\":false},\"ok\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"location\":null,\"name\":null,\"age\":null,\"registered_at\":null}},\"linkedin\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"bio\":null,\"city\":null,\"country\":null,\"country_code\":null,\"facebook_url\":null,\"first_name\":null,\"friends_count\":null,\"gender\":null,\"last_name\":null,\"picture_base64\":null,\"profile_url\":null,\"twitter_url\":null,\"username\":null}},\"yahoo\":{\"error\":false,\"is_registered\":false},\"airbnb\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"about\":null,\"is_verified\":false,\"location\":null,\"name\":null,\"picture_base64\":null,\"profile_url\":null,\"registered_at\":{\"datetime\":null,\"timestamp\":null},\"reviewed_count\":null,\"school\":null,\"trips\":null,\"work\":null}},\"hulu\":{\"error\":false,\"is_registered\":false},\"etoro\":{\"error\":false,\"is_registered\":false},\"gravatar\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"picture_base64\":null,\"picture_last_modified\":null,\"username\":null}},\"yandex\":{\"error\":false,\"is_registered\":false},\"apple\":{\"error\":false,\"is_registered\":false},\"spotify\":{\"error\":false,\"is_registered\":false},\"academia\":{\"error\":false,\"is_registered\":false},\"activision\":{\"error\":false,\"is_registered\":false},\"adobe\":{\"error\":false,\"is_registered\":false},\"archive\":{\"error\":false,\"is_registered\":false},\"callofduty\":{\"error\":false,\"is_registered\":false},\"dhgate\":{\"error\":false,\"is_registered\":false},\"disneyplus\":{\"error\":false,\"is_registered\":false},\"economictimes\":{\"error\":false,\"is_registered\":false},\"espn\":{\"error\":false,\"is_registered\":false},\"hp\":{\"error\":false,\"is_registered\":false},\"lastfm\":{\"error\":false,\"is_registered\":false},\"okcupid\":{\"error\":false,\"is_registered\":false},\"pof\":{\"error\":false,\"is_registered\":false},\"soundcloud\":{\"error\":false,\"is_registered\":false},\"vk\":{\"error\":false,\"is_registered\":false},\"stripe\":{\"error\":false,\"is_registered\":false},\"flickr\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"about\":null,\"city\":null,\"country\":null,\"country_code\":null,\"facebook_url\":null,\"first_name\":null,\"followers\":null,\"following\":null,\"full_name\":null,\"instagram_url\":null,\"last_name\":null,\"occupation\":null,\"picture_base64\":null,\"picture_count\":null,\"picture_last_modified\":null,\"profile_url\":null,\"registered_at\":null,\"twitter_url\":null,\"username\":null,\"username_secondary\":null,\"view_count\":null}},\"facebook\":{\"error\":false,\"is_registered\":false},\"ebay\":{\"error\":false,\"is_registered\":false},\"imgur\":{\"error\":false,\"is_registered\":false},\"discord\":{\"error\":false,\"is_registered\":false},\"disqus\":{\"error\":false,\"is_registered\":false},\"pinterest\":{\"error\":false,\"is_registered\":false},\"quora\":{\"error\":false,\"is_registered\":false},\"nextdoor\":{\"error\":false,\"is_registered\":false},\"quizlet\":{\"error\":false,\"is_registered\":false},\"rambler\":{\"error\":false,\"is_registered\":false},\"realtor\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"status\":null}},\"redfin\":{\"error\":false,\"is_registered\":false},\"remind\":{\"error\":false,\"is_registered\":false},\"shaadi\":{\"error\":false,\"is_registered\":false},\"smule\":{\"error\":false,\"is_registered\":false},\"tagged\":{\"error\":false,\"is_registered\":false},\"talent\":{\"error\":false,\"is_registered\":false},\"envato\":{\"error\":false,\"is_registered\":false},\"evernote\":{\"error\":false,\"is_registered\":false},\"flipkart\":{\"error\":false,\"is_registered\":false},\"freelancer\":{\"error\":false,\"is_registered\":false},\"gaana\":{\"error\":false,\"is_registered\":false},\"gearbest\":{\"error\":true},\"giphy\":{\"error\":false,\"is_registered\":false},\"edx\":{\"error\":false,\"is_registered\":false},\"flightaware\":{\"error\":false,\"is_registered\":false},\"foodnetwork\":{\"error\":false,\"is_registered\":false},\"jd\":{\"error\":false,\"is_registered\":false},\"lastpass\":{\"error\":false,\"is_registered\":false},\"mailru\":{\"error\":false,\"is_registered\":false},\"myfitnesspal\":{\"error\":false,\"is_registered\":false},\"picmonkey\":{\"error\":false,\"is_registered\":false},\"wordpress\":{\"error\":false,\"is_registered\":false},\"eventbrite\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"is_verified\":null,\"signin_methods\":null,\"user_id\":null}},\"duolingo\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"bio\":null,\"is_verified\":null,\"learning_language\":null,\"name\":null,\"picture_base64\":null,\"picture_last_modified\":null,\"profile_url\":null,\"registered_at\":{\"datetime\":null,\"timestamp\":null},\"speaking_language\":null,\"user_id\":null,\"username\":null}},\"strava\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"city\":null,\"country\":null,\"country_code\":null,\"facebook_url\":null,\"first_name\":null,\"full_name\":null,\"last_name\":null,\"picture_base64\":null,\"picture_last_modified\":null,\"profile_url\":null}},\"deezer\":{\"error\":false,\"is_registered\":false},\"instacart\":{\"error\":false,\"is_registered\":false},\"lazada\":{\"error\":false,\"is_registered\":false},\"trivago\":{\"error\":false,\"is_registered\":false},\"ubisoftconnect\":{\"error\":false,\"is_registered\":false},\"wattpad\":{\"error\":false,\"is_registered\":false},\"zoho\":{\"error\":false,\"is_registered\":false},\"fitbit\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"age\":null,\"birth_date\":null,\"first_name\":null,\"gender\":null,\"picture_base64\":null,\"picture_last_modified\":null,\"profile_url\":null,\"registered_at\":null}},\"etsy\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"name\":null,\"picture_base64\":null,\"picture_last_modified\":null}},\"askfm\":{\"error\":false,\"is_registered\":false,\"additional_information\":{\"about\":null,\"answer_count\":null,\"answer_list\":null,\"city\":null,\"country\":null,\"country_code\":null,\"full_name\":null,\"is_verified\":null,\"language\":null,\"like_count\":null,\"online\":null,\"picture_base64\":null,\"picture_last_modified\":{\"datetime\":null,\"timestamp\":null},\"profile_url\":null,\"username\":null}}},\"data_breaches\":{\"breached\":true,\"breach_count\":2,\"first_breach_date\":\"2015-03-01\",\"what_leaked\":[\"Email addresses\",\"IP addresses\"],\"breaches\":[{\"breach_name\":\"000webhost\",\"breach_date\":\"2015-03-01\"},{\"breach_name\":\"2844Breaches\",\"breach_date\":\"2018-02-19\"}]},\"domain\":{\"domain\":\"gmail.com\",\"disposable\":false,\"catch_all\":false,\"registered\":true,\"registered_at\":\"1995-08-12\",\"mx_record\":\"gmail-smtp-in.l.google.com\",\"age_days\":10017,\"smtp_provider\":\"google\"}},\"wallet\":50.12,\"response_time\":3456}"
}
},
"schema": {
"type": "object",
"properties": {
"status": {
"type": "boolean",
"description": "Status of the request, indicating if there is an error or not."
},
"deep_email_check": {
"type": "object",
"description": "JSON object containing the result of the deep check.",
"properties": {
"risk_level": {
"type": "string",
"enum": [
"low",
"medium",
"high",
"extreme"
],
"description": "Simple string representing the overall risk level of the email address."
},
"risk_score": {
"type": "integer",
"description": "A score between ```0``` and ```100```, with ```100``` being the highest level of risk."
},
"email": {
"type": "string",
"description": "The email address against which the analysis ran"
},
"profile_found": {
"type": "integer",
"description": "The count of online profiles we identified registered with this email"
},
"online_profiles": {
"type": "object",
"description": "Data enrichment results concerning the online profiles linked to this email. \n\nRefer to our up-to-date list of the data we gather."
},
"creation_date": {
"type": "object",
"description": "This represents the minimum date of when the email address was actually created. \n\nMore info about its origin here.",
"properties": {
"datetime": {
"type": "string",
"description": "Datetime format (YYY-MM-DD) of the creation date"
},
"timestamp": {
"type": "number",
"description": "Timestamp of the creation date"
}
}
},
"deliverability": {
"type": "string",
"enum": [
"valid",
"catch-all",
"invalid"
],
"description": "The deliverability status of the email address.\n\nMore info here."
},
"signals": {
"type": "array",
"description": "Our Deep Email Check performs various checks against the email address provided to uncover risks or trust signals. This object contains the details about the signals uncovered.\n\nPlease refer to our Deep Email Check signals page to see a description of each check.",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "The technical name of the signal. \n\nPlease refer to our Deep Email Check signals page"
},
"result_type": {
"type": "string",
"enum": [
"risk",
"trust"
],
"description": "Simple string representing the type of signal"
},
"detail": {
"type": "string",
"description": "Message explaining the signals origin"
}
}
}
},
"domain": {
"type": "object",
"description": "Email domain information, useful when the domain is new or never seen before",
"properties": {
"domain": {
"type": "string",
"description": "The domain of the email address"
},
"disposable": {
"type": "boolean",
"description": "Was the domain found to be disposable? \n\nMore info about its origin here."
},
"catch_all": {
"type": "boolean",
"description": "Is the domain a catch-all server"
},
"registered": {
"type": "boolean",
"description": "State of the domain registration status"
},
"registered_at": {
"type": "string",
"description": "Datetime of the domain registration date (YYYY-MM-DD)"
},
"mx_records": {
"type": "integer",
"description": "The domain's DNS MX records"
},
"age_days": {
"type": "integer",
"description": "The number of days since the domain was first registered"
},
"smtp_provider": {
"type": "string",
"description": "If known, the SMTP provider behind the email address"
}
}
},
"data_breaches": {
"type": "object",
"description": "This object contains all the information about the presence of the email address in data breaches",
"properties": {
"breached": {
"type": "boolean",
"description": "This value is ```true``` if the email was breached, ```false``` otherwise"
},
"breach_count": {
"type": "integer",
"description": "Integer representing the number of time a email was involved in a data breach"
},
"first_breach_date": {
"type": "string",
"description": "The date of the first data breach this email was involved in (format ```YYYY-MM-DD```)"
},
"what_leaked": {
"type": "array",
"description": "An array of string representing what element linked to the email leaked such as ```Address, Email, Location...```",
"items": {
"type": "string"
}
},
"breaches": {
"type": "array",
"description": "An array of string representing the name of the data breaches this email was involved in, such as ```Facebook 2017, LinkedIn Breach 2016...```",
"items": {
"type": "string"
}
}
}
}
}
},
"request_id": {
"type": "string",
"description": "Unique random identifier of the request. It can be used in the Observer to retrieve result"
},
"wallet": {
"type": "number",
"description": "Your remaining wallet funds"
}
}
}
}
}
},
"400": {
"description": "When a request results in error, a 400 HTTP code will always be returned. The response contains details about the error.\n\nProperties of the response: - status : false *(always false when there is an error)*
- error_type : \"INVALID_API_KEY\" *(Refer to our Error handling page)*
- error_message : \"This API key is invalid.\"
",
"content": {
"application/json": {
"examples": {
"Result": {
"value": "{\"status\": false,\"error_message\": \"This API key is invalid.\", \"error_type\": \"INVALID_API_KEY\"}"
}
},
"schema": {
"type": "object",
"properties": {
"status": {
"type": "boolean",
"description": "Indicate if the request succeeded (```false``` indicates an error). It should be checked before acting on the response."
},
"error_type": {
"type": "string",
"description": "Short identifier representing the type of error that occured. Present only if a request failed (```status``` is ```false```). Refer to our Error handling page."
},
"error_message": {
"type": "string",
"description": "Description of the ```error_type```. Present only if a request failed (```status``` is ```false```)."
}
}
}
}
}
}
},
"deprecated": false
}
}
},
"x-readme": {
"headers": [],
"explorer-enabled": false,
"proxy-enabled": false,
"samples-enabled": false
},
"_id": {
"buffer": {
"0": 99,
"1": 197,
"2": 134,
"3": 96,
"4": 109,
"5": 78,
"6": 1,
"7": 0,
"8": 23,
"9": 237,
"10": 7,
"11": 181
}
}
}
````