> ## Documentation Index > Fetch the complete documentation index at: https://docs.go.gbgplc.com/llms.txt > Use this file to discover all available pages before exploring further. # 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. 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)](/docs/go-v2/platform/modules/data/data-verification#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 JSON theme={null} { "resourceId": "", "context": { "config": { "delivery": "api" }, "subject": { "identity": { "firstName": "JOHN", "lastNames": ["SMITH"], "dateOfBirth": "1975-02-28", "emails": [ { "type": "email", "email": "joe@target.com" } ], "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 JSON theme={null} { "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" } } ``` ## 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 JSON theme={null} { "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 JSON theme={null} { "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" } } ``` ## 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 JSON theme={null} { "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": "couldnot.locate@gmail.com", "type": "other" } ], "firstName": "Missing", "lastNames": [ "Person" ], "phones": [ { "number": "+447700000000", "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 JSON theme={null} { "response": { "advice": {}, "outcome": "Could Not Locate" } } ```