W2 Data Email Validate 010 Service

W2 Data Email Validate 010 Service

W2DataEmailValidate010Service provides a range of fraud intelligence services using the email address as a key data point to generate a customization risk score. User can search data by email address or by a combination of email and IP address. 

Properties

The following properties pertain to this service.

Property Name Type Length Optional/Mandatory Notes
Email
String
300 Mandatory  
IP
String
40 Optional  IPv4


Response

The following is an example response:

<QueryEmailAndIPResponse>
    <Company/>
<Country>US</Country>
<Dob>01/01/1980</Dob>
<DomainAge>1997-06-18T07:00:00Z</DomainAge>
<DomainCategory/>
<DomainCompany/>
<DomainCorporate/>
<DomainCountryMatch i:nil="true"/>
<DomainCountryName>United+States</DomainCountryName>
<DomainExists>Yes</DomainExists>
<DomainName>test.com</DomainName>
<DomainRelevantInfo>Valid Domain from United States</DomainRelevantInfo>
<DomainRelevantInfoID>508</DomainRelevantInfoID>
<DomainRiskCountry i:nil="true"/>
<DomainRiskLevel>Moderate</DomainRiskLevel>
<DomainRiskLevelID>3</DomainRiskLevelID>
<EAAdvice>Fraud Review</EAAdvice>
<EAAdviceID>1</EAAdviceID>
<EAReason>Fraud Level 3</EAReason>
<EAReasonID>1</EAReasonID>
<EARiskBand>Fraud Score 900 to 999</EARiskBand>
<EARiskBandID>6</EARiskBandID>
<EAScore>973</EAScore>
<EAStatusID>2</EAStatusID>
<EName>UNKNOWN+P</EName>
<Email>test@test.com</Email>
<EmailAge/>
<EmailExists>Yes</EmailExists>
<Fraud_type>Card Not Present Fraud</Fraud_type>
<Gender/>
<IpAddress>100.100.100.100</IpAddress>
<IpDomain/>
<IpTimezone/>
<Ip_Anonymousdetected/>
<Ip_CallingcCode i:nil="true"/>
<Ip_City/>
<Ip_CityConf/>
<Ip_ContinentCode/>
<Ip_CorporateProxy/>
<Ip_Country/>
<Ip_CountryCode/>
<Ip_Countryconf/>
<Ip_Isp/>
<Ip_MetroCode/>
<Ip_NetSpeedCell/>
<Ip_Org/>
<Ip_PostalCode/>
<Ip_PostalConf/>
<Ip_Region/>
<Ip_RegionConf/>
<Ip_Reputation>Good</Ip_Reputation>
<Ip_RiskLevel>Moderate</Ip_RiskLevel>
<Ip_RiskLevelId>3</Ip_RiskLevelId>
<Ip_RiskReason>Moderate Risk</Ip_RiskReason>
<Ip_RiskReasonId>301</Ip_RiskReasonId>
<Ip_RisksCore/>
<Ip_UserType/>
<Location>North+Pole,+Canada</Location>
<Title/>  </QueryEmailAndIPResponse>


The table below contains explanations for the fields returned in the response:

 

Field Type Explanation
 Company
String
The name of the company in which the email belongs
 Country
String
Domain Country Code
 Dob
String
The date of birth for the person who owns the email address.
 DomainAge
datetime
The creation date of the domain. This field may be blank for
some queries. Returned in UTC format
 DomainCategory
String
The category type for the company in which the email belongs.
 DomainCompany
String
 The domain of the company in which the email belongs.
 DomainCorporate
String
Possible values:

Yes
No
Null

 DomainCountryMatch
String

***FUTURE ENHANCEMENT – The logic for this field will be implemented at a later date***


This field can be either Yes, No, or blank. Value indicates whether the country of the Email matched the billing address country. A mismatch indicates a higher risk of fraud. If no country input was provided, this field will be left blank
Pre-defined Input Parameters required to return a value:
- billcountry

 DomainCountryName
String
The country of the company in which the email belongs.
 DomainExists  
String
Verification of whether the email domain exists. Values are:

Yes
No
Not Anymore
Not Sure

 DomainName  
String
The email address domain name.
 DomainRelevantInfo  
Int
The relevant info description. See domainrelevantinfoID
 DomainRelevantInfoID  
Int
501 - NoKnownRisk
502 - RiskCountry
503 - HighRiskCategory
504 - HighRiskDomain
505 - RecentlyCreated
506 - InvalidDomain
507 - LowRiskCategory
508 - ValidDomainFromCountry
509 - ValidDomain
510 - LowRiskDomain
511 - ReviewRiskCategory
521 - LowRiskEmailDomainforCompany
522 - LowRiskEmailDomainforIndustry
523 - LowRiskEmailDomainforNetwork
524 - VeryLowRiskEmailDomainforCompany
525 - VeryLowRiskEmailDomainforIndustry
526 - VeryLowRiskEmailDomainforNetwork
527 - HighRiskEmailDomainforCompany
528 - HighRiskEmailDomainforIndustry
529 - HighRiskEmailDomainforNetwork
530 - VeryHighRiskEmailDomainforCompany
531 - VeryHighRiskEmailDomainforIndustry
532 - VeryHighRiskEmailDomainforNetwork
 DomainRiskCountry  
String

***FUTURE ENHANCEMENT – The logic for this field will be implemented at a later date***


This field can be either Yes or No. The field will be set to “Yes”

if the country associated with the email’s domain is
associated with a high risk of fraud; otherwise, it will be set to “No”

Pre-defined Input Parameters required to return a value:
- billcountry

 DomainRiskLevel  
String
The risk level description. See domainrisklevelID above.
 DomainRiskLevelID  
Int
 Possible values:

1 - VeryHigh
2 - High
3 - Moderate
4 - Low
5 - VeryLow
6 - Review

 EAAdvice  
String
Serves as a guideline based on the risk associated with the
email address.
 EAAdviceID  
String

Serves as a guideline based on the risk associated with the email address.

1 - Fraud Review
2 - Unclear Risk
3 - Lower Fraud Risk
4 - Moderate Fraud Risk
11 - Data Entry Review
1001 - Custom Fraud Score Define

 EAReason  
String
Provides relevant information to understand the Fraud Score. See above for all possible values.
 EAReasonID  
String

Possible values are:

1 - Fraud Level X
2 - Email does not exist
3 - Domain does not exist
4 - Risky Domain
5 - Risky Country
6 - Risky Email Name
7 - Numeric Email
8 - Limited History for Email
9 - Email Recently Created
10 - Email linked to High Risk Account
11 - Good Level X
12 - Low Risk Domain
13 - Email Created X Years Ago
14 - Email Created at least X Years Ago
15 - Email Linked to Low Risk Account
16 - InvalidEmailSyntax
17 - Mailbox is Full
18 - Mailbox is Inactive
19 - Corporate Link
20 - Mailbox is Expired
21 - User Defined Risk Domain
22 - User Defined Low Risk Domain
23 - Velocity Level X
24 - Risk Domain Category
25 - Low Risk Domain Category
26 - High Risk Email Account
27 - Email Created at least X Months Ago
28 - Valid Email From X Country Domain
29 - Valid Domain From X Country
30 - Potentially Breached Email
31 - Fraud Emails Linked X
32 - Good Email Linked Level X
33 - Fraud IP Level X
34 - Good IP Level X
35 - Risky Proxy IP
36 - Risk IP Behavior
37 - Risky IP Country
38 - IP Not Found
39 - IP Invalid Syntax Format
40 - High Risk IP
51 - Good Popularity
52 - Risk Domain Category Review
53 - Tumbling Abuse
54 - Email Enumeration for Company
55 - Email Enumeration for Industry
61 - Customer Email not Provided
62 - Risk Email Pattern
63 - Suspected Fraud
101 - Low Risk Email Domain for Company
102 - Low Risk IP for Company
103 - Low Risk IP Geolocation for Company
104 - Low Risk Email Domain for Industry
105 - Low Risk IP for Industry
106 - Low Risk IP Geolocation for Industry
107 - Low Risk Email Domain for Network
108 - Low Risk IP for Network
109 - Low Risk IP Geolocation for Network
110 - Very Low Risk Email Domain for Company
111 - Very Low Risk IP for Company
112 - Very Low Risk IP Geolocation for Company
113 - Very Low Risk Email Domain for Industry
114 - Very Low Risk IP for Industry
115 - Very Low Risk IP Geolocation for Industry
116 - Very Low Risk Email Domain for Network
117 - Very Low Risk IP for Network
118 - Very Low Risk IP Geolocation for Network
121 - High Risk Email Domain for Company
122 - High Risk IP for Company
123 - High Risk IP Geolocation for Company
124 - High Risk Email Domain for Industry
125 - High Risk IP for Industry
126 - High Risk IP Geolocation for Industry
127 - High Risk Email Domain for Network
128 - High Risk IP for Network
129 - High Risk IP Geolocation for Network
130 - Very High Risk Email Domain for Company
131 - Very High Risk IP for Company
132 - Very High Risk IP Geolocation for Company
133 - Very High Risk Email Domain for Industry
134 - Very High Risk IP for Industry
135 - Very High Risk IP Geolocation for Industry
136 - Very High Risk Email Domain for Network
137 - Very High Risk IP for Network
138 - Very High Risk IP Geolocation for Network

 EARiskBand  
String

You can create customised risk levels for your business. You can also view specific elements or attributes associated with an email and customise results. Emailage provides 6 preloaded and recommended 'Risk Band' score ranges.
Admins can update these ranges or add up to 20 new ranges

 EARiskBandID  
Int
You can create customised risk levels for your business. You can also view specific elements or attributes associated with an email and customise results. Emailage provides 6 preloaded and recommended 'Risk Band' score ranges.
Admins can update these ranges or add up to 20 new ranges
 EAScore  
String
Proprietary algorithm that calculates the fraud risk
associated with an email address.
 EAStatusID  
String
The possible values of EAStatusID:

0 - GeneralError
1 - Certified
2 - Verified
3 - EmailNonxistent
4 - ValidDomain
5 - DomainInexistent

 EName  
String
The name of the person who owns the email address
 Email  
String
Email address provided for the query
 EmailAge  
datetime
The creation date of the email. This field may be blank for some queries. Returned in UTC format
 EmailExists  
String
Verification of whether the email address exists. Values are:

Yes
No
Not Anymore
Not Sure

 Fraud_type  
String
This field provides the type of fraud marked for the queried value. If multiple companies within our system marked the queried value as fraud, we provide the fraud type of the latest company that made the marking. Please note: this field will ONLY be returned for queries that were marked as
fraud in our system. Possible values are:

-Card Not Present Fraud
-Customer Dispute (Chargeback)
-First Party Fraud
-First Payment Default
-Identify Theft (Fraud Application)
-Identify Theft (Account Take Over)
-Suspected Fraud (Not Confirmed)
-Synthetic ID
-Other

 Gender  
String
The gender of the person who owns the email address
 IpAddress  
String
IP address provided for the query
 IpDomain  
String
The second level domain associated with the IP address.
This will be something like “example.com” or
“example.co.uk”, not “foo.example.com”
 IpTimezone  
String
The time zone associated with the IP address. Time zone names are taken from the IANA time zone database
 Ip_Anonymousdetected  
String
Indicates whether the user's IP address is an anonymous proxy. The values for this field are:

Yes
No

 Ip_CallingcCode  
String
The calling code (area code) for the IP.
 Ip_City  
String
For US, the city where the IP is located (e.g. San Francisco) 
 Ip_CityConf  
String
 
 Ip_ContinentCode  
String
The continent associated with the IP, e.g. North America
 Ip_CorporateProxy  
String
Indicates whether the user's IP address is a known
corporate proxy. This field can be either Yes or No.
 Ip_Country  
String
The name of the country associated with the IP.
 Ip_CountryCode  
String
A two-character ISO 3166-1 country code for the country associated with the IP address. In addition to the standard codes, we may also return one of the following:

A1 - an anonymous proxy.
A2 - a satellite provider.
EU - an IP in a block used by multiple European countries.
AP - an IP in a block used by multiple Asia/Pacific region countries. The US country code is returned for IP addresses associated with overseas US military bases.

 Ip_Countryconf  
String
 
 Ip_Isp  
String
The name of the service provider for the IP (e.g. Optimum Online).
 Ip_MetroCode  
String
The metro code associated with the IP address. These are only available for IP addresses in the US.
 Ip_NetSpeedCell  
String
The network speed associated with the IP address. This can be one of the following values:

Dialup
Cable/DSL
Corporate
Cellular

 Ip_Org  
String
The organization associated with the IP (e.g. HSA-UWC).
 Ip_PostalCode  
String
 
 Ip_PostalConf  
String
 
 Ip_Region  
String
For US, the state where the IP is located (e.g. California).
 Ip_RegionConf  
String
 
 Ip_Reputation  
String
The reputation of the proxy, indicates the likelihood that the user's IP address is an open proxy. The values for this field are:

Good
Moderate
High Risk
Very High Risk

 Ip_RiskLevel  
String
 See Ip_RiskLevelId
 Ip_RiskLevelId  
String
Provides the fraud risk for the IP Address, the values for this field are:

1 - Very High
2 - High
3 - Moderate
4 - Low
5 - Very Low

 Ip_RiskReason  
String
 See Ip_RiskReasonId
 Ip_RiskReasonId  
String
Provides relevant information (most important reason) to understand the IP Risk Level:

301 - Moderate Risk
307 - Risk Country
308 - Anonymous Proxy
309 - Risk Proxy
310 - IP Not Found
311 - Moderate By Proxy Reputation And Country Code
312 - Invalid IP Syntax
313 - TOR Network IP
321 - Low Risk IP for Company
322 - Low Risk IP Geolocation for Company
323 - Low Risk IP for Industry
324 - Low Risk IP Geolocation for Industry
325 - Low Risk IP for Network
326 - Low Risk IP Geolocation for Network
327 - Very Low Risk IP for Company
328 - Very Low Risk IP Geolocation for Company
329 - Very Low Risk IP for Industry
330 - Very Low Risk IP Geolocation for Industry
331 - Very Low Risk IP for Network
332 - Very Low Risk IP Geolocation for Network
333 - High Risk IP for Company
334 - High Risk IP Geolocation for Company
335 - High Risk IP for Industry
336 - High Risk IP Geolocation for Industry
337 - High Risk IP for Network
338 - High Risk IP Geolocation for Network
339 - Very High Risk IP for Company
340 - Very High Risk IP Geolocation for Company
341 - Very High Risk IP for Industry
342 - Very High Risk IP Geolocation for Industry
343 - Very High Risk IP for Network
344 - Very High Risk IP Geolocation for Network

 Ip_RisksCore  
String
 
 Ip_UserType  
String
The user type associated with the IP address. This will be one of the following values:

business
cafe
cellular
college
contentDeliveryNetwork
government
hosting
library
military
residential
router
school
searchEngineSpider
traveler

 Location  
String
The location of the person who owns the email address.
 Title  
String
The title of the email owner.

 

 



ServiceTransactions Result

If input an invalid Email= "adfdfd":

The W2DataEmailValidate010EmailAndIpResult will be null and the corresponding ServiceTransactions will show the following properties:

HaltTriggered False
ServiceTransactionResult Failed
ServiceInterpretResult NotApplicable
ServiceTransactionResultMessage "Required field not supplied - Email"
ValidationResult Failed

If input a valid email ="test@test.com":

The W2DataEmailValidate010EmailAndIpResult will have 1 result and the corresponding ServiceTransactions will show the following properties:

HaltTriggered False
ServiceTransactionResult Success
ServiceInterpretResult OneResult
ServiceTransactionResultMessage "This call was generated using sandbox mode"
ValidationResult Pass

There are also the following addresses that return different results ="test2@test.com", "test3@test.com", "test4@test.com" and "test5@test.com".

Sandbox

Sandbox mode can be used to test the service. By setting the following query option the API will only respond with mocked requests from pre-configured responses.

<QueryOptions>
  <KeyValueOfstringstring>
    <Key>Sandbox</Key>
    <Value>true</Value>
  </KeyValueOfstringstring>
</QueryOptions>

Sending the following request, as well as the Sandbox Query option mentioned above, will return the response below:

Request

<QueryData>
<Email>test@test.com</Email>
</QueryData>
<QueryOptions>
<KeyValueOfstringstring>
<Key>Sandbox</Key>
<Value>True</Value>
</KeyValueOfstringstring>
</QueryOptions>

Response

<W2DataEmailValidate010EmailAndIpResult>
<Company>Emailage+Corp</c:Company>
<Country>US</c:Country>
<Dob/>
<DomainAge>2012-05-01T07:00:00Z</DomainAge>
<DomainCategory>Fraud+Mitigation+Services</DomainCategory>
<DomainCompany>Emailage+Corp</DomainCompany>
<DomainCorporate>Yes</DomainCorporate>
<DomainCountryMatch i:nil="true"/>
<DomainCountryName>United+States</DomainCountryName>
<DomainExists>Yes</DomainExists>
<DomainName>emailage.com</DomainName>
<DomainRelevantInfo>Low Risk Domain</DomainRelevantInfo>
<DomainRelevantInfoID>510</DomainRelevantInfoID>
<DomainRiskCountry i:nil="true"/>
<DomainRiskLevel>Low</DomainRiskLevel>
<DomainRiskLevelID>4</DomainRiskLevelID>
<EAAdvice>Lower Fraud Risk</EAAdvice>
<EAAdviceID>3</EAAdviceID>
<EAReason>Email Created at least 2.4 Years Ago</EAReason>
<EAReasonID>14</EAReasonID>
<EARiskBand>Fraud Score 101 to 300</EARiskBand>
<EARiskBandID>2</EARiskBandID>
<EAScore>181</EAScore>
<EAStatusID>4</EAStatusID>
<EName/>
<Email>user@emailage.com</Email>
<EmailAge/>
<EmailExists>Not Sure</EmailExists>
<Fraud_type/>
<Gender/>
<IpAddress i:nil="true"/>
<IpDomain i:nil="true"/>
<IpTimezone i:nil="true"/>
<Ip_Anonymousdetected i:nil="true"/>
<Ip_CallingcCode i:nil="true"/>
<Ip_City i:nil="true"/>
<Ip_CityConf i:nil="true"/>
<Ip_ContinentCode i:nil="true"/>
<Ip_CorporateProxy i:nil="true"/>
<Ip_Country i:nil="true"/>
<Ip_CountryCode i:nil="true"/>
<Ip_Countryconf i:nil="true"/>
<Ip_Isp i:nil="true"/>
<Ip_MetroCode i:nil="true"/>
<Ip_NetSpeedCell i:nil="true"/>
<Ip_Org i:nil="true"/>
<Ip_PostalCode i:nil="true"/>
<Ip_PostalConf i:nil="true"/>
<Ip_Region i:nil="true"/>
<Ip_RegionConf i:nil="true"/>
<Ip_Reputation i:nil="true"/>
<Ip_RiskLevel i:nil="true"/>
<Ip_RiskLevelId i:nil="true"/>
<Ip_RiskReason i:nil="true"/>
<Ip_RiskReasonId i:nil="true"/>
<Ip_RisksCore i:nil="true"/>
<Ip_UserType i:nil="true"/>
<Location/>
<Title/>
</W2DataEmailValidate010EmailAndIpResult>