Email Insights

Validate email addresses in GBG Go and surface fraud-related risk signals such as disposable addresses, tumbled addresses, and high-risk domains.

The Email Insights module validates email addresses and surfaces fraud-related risk signals. It checks whether an email address is valid and deliverable, and returns risk codes that identify disposable addresses, tumbled addresses, high-risk domains, and other fraud indicators.

Global Email Validation and Fraud Insights (Legacy)

Validates email addresses globally and returns both a pass/fail verification result and detailed risk codes that identify disposable addresses, tumbled addresses, high-risk domains, and other fraud indicators. Requires the subject’s full name and personal email.

Capabilities

This variant returns an email verification result alongside risk codes that describe the email address and its domain.

Email result

Code	Label	Description
expectid.email.verify.success	Email pass	The email address was successfully verified.
expectid.email.verify.failure	Email fail	The email address couldn’t be verified.

Email risk codes

Code	Label	Description
resultcode.email.domain.does.not.exist	Email or domain does not exist	The email address or its domain doesn’t exist.
resultcode.high.risk.email.fraud	High risk email - fraud	The email address is associated with known fraud activity.
resultcode.high.risk.email.tumbled	High risk email - tumbled	The email address appears to be tumbled, where slight variations of a known address are used to create multiple identities.
resultcode.high.risk.email.disposable	High risk email - disposable	The email address uses a disposable or temporary email service.
resultcode.high.risk.email.domain	High risk email - domain	The email domain is flagged as high risk.
resultcode.high.risk.email.country	High risk email - country	The email is associated with a high-risk country.
resultcode.private.email.domain	Private email domain	The email uses a private consumer domain such as Gmail or Yahoo.
resultcode.corporate.email.domain	Corporate email domain	The email uses a corporate domain.
resultcode.email.inbox.is.full	Email inbox is full	The email inbox is full.
resultcode.email.recently.verified	Email recently verified	The email address was recently verified in a previous check.
resultcode.domain.recently.verified	Domain recently verified	The email domain was recently verified in a previous check.
resultcode.invalid.email.address	Invalid email address	The email address format is invalid.
resultcode.email.no.hit	Email - no hit	No data was found for the email address.
resultcode.email.service.not.available	Email service not available	The email verification service is unavailable.

This variant also returns Trust USA risk and result capabilities. These use the same enumset documented under US: Source 2 (Legacy) on the Data Verification page.

Trust USA risk capabilities

Trust USA Risk Capabilities

Value	Description
ADDR4	Street Address w/ SSN4
ADDR	Street Address
IADDR4	Street Address w/ SSN4
IADDR	Street Address
IALTADDR	Alternate Street Address
IALT	Alternate Street Address
IBADDR	Business Address
IBDBA	Business DBA Name
IBDBANAME	Business DBA Name
IBFEIN	Business FEIN
IBNAME	Business Name
IDOC	Document Number
IEMAILDOM	Email Domain
IEMAIL	Email Address
IEMAILIADDR	Email Address w/ Input Street Address
IEMAILIIPADDR	Email Address w/ Input IP Address
IEMAILIPHONE	Email Address w/ Input Phone Number
IEMAILISSN9	Email Address w/ Input SSN9
IFIRST	First Name
IIPADDRIADDR	IP Address w/ Input Street Address
IIPADDR	IP Address
IIPADDRIPHONE	IP Address w/ Input Phone Number
IIPADDRISSN9	IP Address w/ Input SSN9
IIP	IP Address
ILAST	Last Name
ILNAME4	Last Name w/ SSN4
INAME2	First Name and Last Name
INAME4	Last Name and Street Address w/ SSN4
INAME	Last Name and Street Address
IPHONEIADDR	Phone Number w/ Input Street Address
IPHONEISSN9	Phone Number w/ Input SSN9
IPHONE	Phone Number
ISKU	SKU
ISNAME	Street Name
ISNBR	Street Number
ISSN4	SSN4
ISSN9	SSN9
ISTRNZIP	Street Name and ZIP Code
IZIP	ZIP Code
LDOC	Document Number
LFIRST	First Name
LLAST	Last Name
LNAME4	Last Name w/ SSN4
LPHONE	Phone Number
LSAC	Street Name and Unit Designation
LSNAME	Street Name
LSNBR	Street Number
LSSN4	SSN4
LSSN9	SSN9
LZIP	ZIP Code
NAME2	First Name and Last Name
NAME4	Last Name and Street Address w/ SSN4
NAME	Last Name and Street Address
PHONE	Phone Number
SSN9	SSN9
STRNZIP	Street Name and ZIP Code
pass	Pass
fail	Fail
refer	Refer

Trust USA result capabilities

Trust USA Result Capabilities

Value	Description
pass	Pass
fail	Fail
refer	Refer

Default outcomes

Outcome	Condition	Description
Verified	Email result includes expectid.email.verify.success	The email address was verified.
Not Verified	Email result includes expectid.email.verify.failure	The email address couldn’t be verified. Check the risk codes for the specific reason.
ERROR	Default (no conditions matched)	An unexpected error occurred.

Input payload

The following is a sample payload used to submit subject details to the Global Email Validation and Fraud Insights (Legacy) variant for processing.

JSON

{
  "resourceId": "<resourceId>",
  "context": {
    "config": {
      "delivery": "api"
    },
    "subject": {
      "identity": {
        "firstName": "JOHN",
        "lastNames": ["SMITH"],
        "dateOfBirth": "1975-02-28",
        "emails": [
          {
            "type": "email",
            "email": "[e-mail]"
          }
        ],
        "phones": [
          {
            "type": "mobile",
            "number": "9193740211"
          }
        ],
        "currentAddress": {
          "lines": ["222333 PEACHTREE PLACE"],
          "locality": "ATLANTA",
          "dependentLocality": "GA",
          "postalCode": "30318",
          "country": "US"
        }
      }
    }
  }
}

Field	Required	Description
identity.firstName	Yes	First name of the subject.
identity.lastNames	Yes	Array containing the last name(s) of the subject.
identity.emails[].type	Yes	Type of email address, for example "email".
identity.emails[].email	Yes	Email address of the subject.
identity.dateOfBirth	No	Date of birth in YYYY-MM-DD format.
identity.phones[].type	No	Type of phone number, for example "mobile".
identity.phones[].number	No	Phone number of the subject.
identity.currentAddress.lines	No	Array of address lines.
identity.currentAddress.locality	No	Town or city.
identity.currentAddress.dependentLocality	No	State or region.
identity.currentAddress.postalCode	No	Postal or ZIP code.
identity.currentAddress.country	No	Country code, for example "US".

Sample response

The following is a sample response where the email verified but high-risk fraud signals were detected.

JSON

{
  "response": {
    "advice": {
      "equals": {
        "email_risk_capabilities": [
          "resultcode.high.risk.email.fraud",
          "resultcode.high.risk.email.disposable",
          "resultcode.high.risk.email.domain"
        ],
        "email_result_capabilities": [
          "expectid.email.verify.success"
        ],
        "trust_usa_risk_capabilities": [],
        "trust_usa_result_capabilities": []
      }
    },
    "outcome": "Verified"
  }
}

Global Email Insights

Capabilities

Execution status

Execution status for outcome routing: COMPLETE = successful Idology response; ERROR = any service failure (JSON-level errors such as invalid credentials, or XML service-not-available responses)

Value	Description
COMPLETE	No JSON-level error from Idology
ERROR	Service failure from Idology (JSON-level error or XML service-not-available response)

Days email verified

Number of days the email has been verified for

Detail	Description
Type	Integer
Range	0–2147483647
Default	0

Days domain verified

Number of days the domain has been verified for

Detail	Description
Type	Integer
Range	0–2147483647
Default	0

Domain country code

Domain country code (ISO2)

Value	Description
“	Unknown or not provided
AF	Afghanistan
AL	Albania
DZ	Algeria
AS	American Samoa
AD	Andorra
AO	Angola
AI	Anguilla
AQ	Antarctic Treaty area
AG	Antigua and Barbuda
AR	Argentina
AM	Armenia
AW	Aruba
AU	Australia
AT	Austria
AZ	Azerbaijan
BH	Bahrain
BD	Bangladesh
BB	Barbados
BY	Belarus
BE	Belgium
BZ	Belize
BJ	Benin
BM	Bermuda
BT	Bhutan
BO	Bolivia
BA	Bosnia and Herzegovina
BW	Botswana
BV	Bouvet Island
BR	Brazil
IO	British Indian Ocean Territory
VG	British Virgin Islands
BN	Brunei
BG	Bulgaria
BF	Burkina Faso
BI	Burundi
KH	Cambodia
CM	Cameroon
CA	Canada
CV	Cape Verde
BQ	Caribbean Netherlands
KY	Cayman Islands
CF	Central African Republic
TD	Chad
CL	Chile
CX	Christmas Island
CC	Cocos (Keeling) Islands
CO	Colombia
KM	Comoros
CK	Cook Islands
CR	Costa Rica
HR	Croatia
CU	Cuba
CW	Curaçao
CY	Cyprus
CZ	Czech Republic
CD	Democratic Republic of the Congo
DK	Denmark
DJ	Djibouti
DM	Dominica
DO	Dominican Republic
TL	East Timor
EC	Ecuador
EG	Egypt
SV	El Salvador
GQ	Equatorial Guinea
ER	Eritrea
EE	Estonia
SZ	Eswatini
ET	Ethiopia
FK	Falkland Islands
FO	Faroe Islands
FM	Federated States of Micronesia
FJ	Fiji
FI	Finland
FR	France
GF	French Guiana
PF	French Polynesia
TF	French Southern and Antarctic Lands
GA	Gabon
GE	Georgia
DE	Germany
GH	Ghana
GI	Gibraltar
GR	Greece
GL	Greenland
GD	Grenada
GP	Guadeloupe
GU	Guam
GT	Guatemala
GG	Guernsey
GN	Guinea
GW	Guinea-Bissau
GY	Guyana
HT	Haiti
HM	Heard Island and McDonald Islands
HN	Honduras
HK	Hong Kong
HU	Hungary
IS	Iceland
IN	India
ID	Indonesia
IR	Iran
IQ	Iraq
IE	Ireland
IM	Isle of Man
IL	Israel
IT	Italy
CI	Ivory Coast
JM	Jamaica
JP	Japan
JE	Jersey
JO	Jordan
KZ	Kazakhstan
KE	Kenya
NL	Kingdom of the Netherlands
KI	Kiribati
KW	Kuwait
KG	Kyrgyzstan
LA	Laos
LV	Latvia
LB	Lebanon
LS	Lesotho
LR	Liberia
LY	Libya
LI	Liechtenstein
LT	Lithuania
LU	Luxembourg
MO	Macau
MG	Madagascar
MW	Malawi
MY	Malaysia
MV	Maldives
ML	Mali
MT	Malta
MH	Marshall Islands
MQ	Martinique
MR	Mauritania
MU	Mauritius
YT	Mayotte
MX	Mexico
MD	Moldova
MC	Monaco
MN	Mongolia
ME	Montenegro
MS	Montserrat
MA	Morocco
MZ	Mozambique
MM	Myanmar
NA	Namibia
NR	Nauru
NP	Nepal
NC	New Caledonia
NZ	New Zealand
NI	Nicaragua
NE	Niger
NG	Nigeria
NU	Niue
NF	Norfolk Island
KP	North Korea
MK	North Macedonia
MP	Northern Mariana Islands
NO	Norway
OM	Oman
PK	Pakistan
PW	Palau
PA	Panama
PG	Papua New Guinea
PY	Paraguay
CN	People’s Republic of China
PE	Peru
PH	Philippines
PN	Pitcairn Islands
PL	Poland
PT	Portugal
PR	Puerto Rico
QA	Qatar
CG	Republic of the Congo
RO	Romania
RU	Russia
RW	Rwanda
RE	Réunion
BL	Saint Barthélemy
SH	Saint Helena, Ascension and Tristan da Cunha
KN	Saint Kitts and Nevis
LC	Saint Lucia
PM	Saint Pierre and Miquelon
VC	Saint Vincent and the Grenadines
MF	Saint-Martin
WS	Samoa
SM	San Marino
SA	Saudi Arabia
SN	Senegal
RS	Serbia
SC	Seychelles
SL	Sierra Leone
SG	Singapore
SX	Sint Maarten
SK	Slovakia
SI	Slovenia
SB	Solomon Islands
SO	Somalia
ZA	South Africa
GS	South Georgia and the South Sandwich Islands
KR	South Korea
SS	South Sudan
ES	Spain
LK	Sri Lanka
PS	State of Palestine
SD	Sudan
SR	Suriname
SJ	Svalbard and Jan Mayen
SE	Sweden
CH	Switzerland
SY	Syria
ST	São Tomé and Príncipe
TW	Taiwan
TJ	Tajikistan
TZ	Tanzania
TH	Thailand
BS	The Bahamas
GM	The Gambia
TG	Togo
TK	Tokelau
TO	Tonga
TT	Trinidad and Tobago
TN	Tunisia
TR	Turkey
TM	Turkmenistan
TC	Turks and Caicos Islands
TV	Tuvalu
UG	Uganda
UA	Ukraine
AE	United Arab Emirates
GB	United Kingdom
UM	United States Minor Outlying Islands
US	United States of America
VI	United States Virgin Islands
UY	Uruguay
UZ	Uzbekistan
VU	Vanuatu
VA	Vatican City
VE	Venezuela
VN	Vietnam
WF	Wallis and Futuna
EH	Western Sahara
YE	Yemen
ZM	Zambia
ZW	Zimbabwe
AX	Åland

Fraud risk

Overall fraud risk level for the email

Value	Description
“	No fraud risk provided by the data source
VERY_LOW	Provider classifies this email as very low fraud risk
LOW	Provider classifies this email as low fraud risk
MEDIUM	Provider classifies this email as medium fraud risk
HIGH	Provider classifies this email as high fraud risk
VERY_HIGH	Provider classifies this email as very high fraud risk

Fraud risk score

Fraud risk score for the email

Detail	Description
Type	Integer
Range	0–2147483647
Default	0

Email fraud type

Type of fraud risk associated with the email

Value	Description
“	No specific fraud type detected
FRAUD	Signals indicate known or suspected fraudulent activity
TUMBLED	Email observed in tumbled/throwaway pools (rotating use)
DISPOSABLE	Email appears to be from a disposable provider
DOMAIN	Domain is flagged as high risk
COUNTRY	Domain country is flagged as high risk

Email fraud signals

All high-risk fraud signals present in the response

Value	Description
FRAUD	Fraud-related signal detected
TUMBLED	Tumbled/throwaway email signal detected
DISPOSABLE	Disposable email signal detected
DOMAIN	High-risk domain signal detected
COUNTRY	High-risk country signal detected

Email risks

Array of email risk codes

Value	Description
resultcode.email.domain.does.not.exist	Email or its domain does not exist
resultcode.private.email.domain	Email uses a private email domain
resultcode.corporate.email.domain	Email uses a corporate/business domain
resultcode.email.inbox.is.full	Mailbox storage is full; delivery may fail
resultcode.email.recently.verified	Email was recently verified by the provider
resultcode.domain.recently.verified	Domain was recently verified by the provider
resultcode.invalid.email.address	Address is syntactically invalid or not recognized
resultcode.email.no.hit	No records found for the email address
resultcode.email.service.not.available	Provider email service unavailable during the request

Email exists

Whether the email address exists

Detail	Description
Type	Boolean
Default	false

Domain exists

Whether the domain exists

Detail	Description
Type	Boolean
Default	false

Email total hits

Total number of hits for the email

Detail	Description
Type	Integer
Range	0–2147483647
Default	0

Email unique hits

Number of unique hits for the email

Detail	Description
Type	Integer
Range	0–2147483647
Default	0

Input payload

The following is a sample payload used to submit data to the Global Email Insights module for processing.

JSON

{
  "equalToFile": "../email_insights/email-insights-not-available-data.json"
}

Field	Required	Description
FullName	Yes	The subject’s full name, including given and family names.
PersonalEmail	Yes	The subject’s personal email address.

Sample response

The following is a sample response returned by the module.

JSON

{
  "response": {
    "advice": {
      "days_domain_verified": 0,
      "days_email_verified": 0,
      "domain_country_code": "",
      "domain_exists": false,
      "email_execution_status": "ERROR",
      "email_exists": false,
      "email_fraud_signals": [],
      "email_fraud_type": "",
      "email_risks": [],
      "email_total_hits": 0,
      "email_unique_hits": 0,
      "fraud_risk": "",
      "fraud_risk_score": 0
    },
    "outcome": "Error"
  }
}

Global Email Validation

Capabilities

Generic email match result

Indicates if the email has matched

Value	Description
match	match
mismatch	mismatch
not available	not available
unrecognised value	unrecognised value
no result	no result

Input payload

The following is a sample payload used to submit data to the Global Email Validation module for processing.

JSON

{
  "context": {
    "subject": {
      "accounts": [
        {
          "accountNumber": "00000000",
          "sortCode": "00-00-00",
          "type": "Bank Account"
        }
      ],
      "documents": [
        {
          "cardNumber": "000",
          "number": "NZ000000",
          "type": "Driving License"
        }
      ],
      "identity": {
        "currentAddress": {
          "country": "GBR",
          "locality": "Anyton",
          "postalCode": "AA1 1AA",
          "premise": "0",
          "thoroughfare": "The Street"
        },
        "dateOfBirth": "2007-03-26",
        "emails": [
          {
            "email": "[e-mail]",
            "type": "other"
          }
        ],
        "firstName": "Missing",
        "lastNames": [
          "Person"
        ],
        "phones": [
          {
            "number": "[phone]",
            "type": "mobile"
          }
        ]
      },
      "uid": "variant-test-user"
    }
  }
}

Field	Required	Description
PersonalEmail	Yes	The subject’s personal email address.

Sample response

The following is a sample response returned by the module.

JSON

{
  "response": {
    "advice": {},
    "outcome": "Could Not Locate"
  }
}