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.

The module has three variants:

• A legacy variant that returns a pass/fail result and risk codes.
• A standardised variant that returns structured advice outputs, recommended for new journeys.
• A validation variant that confirms an email address exists, used as a lightweight pre-check.

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 1 (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": {
    "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

Global Email Insights with standardised advice outputs (fraud_risk, email_risks, domain_country_code, etc.). Recommended for new journeys.

Capabilities

This variant returns a structured set of advice outputs grouped into execution, fraud, and email checks.

Execution

Capability	Type	Values	Description
Execution status	Enum	COMPLETE, ERROR	Execution status for outcome routing. COMPLETE is a successful provider response. ERROR is any service failure, such as invalid credentials or a service-not-available response.

Fraud

Capability	Type	Values	Description
Fraud risk	Enum	VERY_LOW, LOW, MEDIUM, HIGH, VERY_HIGH	Overall fraud risk level for the email. An empty value means no fraud risk was provided by the data source.
Fraud risk score	Integer	0 or greater	Fraud risk score for the email.
Email fraud type	Enum	FRAUD, TUMBLED, DISPOSABLE, DOMAIN, COUNTRY	Type of fraud risk associated with the email. An empty value means no specific fraud type was detected.
Email fraud signals	Enumset	FRAUD, TUMBLED, DISPOSABLE, DOMAIN, COUNTRY	All high-risk fraud signals present in the response.

Email and domain

Capability	Type	Values	Description
Email exists	Boolean	true, false	Whether the email address exists.
Domain exists	Boolean	true, false	Whether the domain exists.
Domain country code	Enum	ISO 3166-1 alpha-2 country code	Country of the email domain, for example US, GB, or DE. An empty value means the country is unknown or not provided.
Days email verified	Integer	0 or greater	Number of days the email has been verified for.
Days domain verified	Integer	0 or greater	Number of days the domain has been verified for.
Email total hits	Integer	0 or greater	Total number of hits for the email.
Email unique hits	Integer	0 or greater	Number of unique hits for the email.

Email risks

This enumset returns zero or more of the following 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.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 or business domain.
resultcode.email.inbox.is.full	Email inbox is full	The mailbox storage is full, so delivery might fail.
resultcode.email.recently.verified	Email recently verified	The email address was recently verified by the provider.
resultcode.domain.recently.verified	Domain recently verified	The domain was recently verified by the provider.
resultcode.invalid.email.address	Invalid email address	The address is syntactically invalid or not recognised.
resultcode.email.no.hit	Email - no hit	No records were found for the email address.
resultcode.email.service.not.available	Email service not available	The provider email service was unavailable during the request.

Default outcomes

Outcome	Condition	Description
Error	Execution status is ERROR, or email risks includes resultcode.email.service.not.available	The email verification service failed.
Verified	Email exists is true and domain exists is true and email fraud type is not FRAUD, TUMBLED, DISPOSABLE, DOMAIN, or COUNTRY and fraud risk is not HIGH or VERY_HIGH and email risks excludes service-not-available, invalid, inbox-full, and no-hit	The email address exists, the domain exists, and no high-risk fraud signals were detected.
Not Verified	Default (no conditions matched)	The email address couldn’t be verified, or a fraud signal was detected.

Input payload

The following is a sample payload used to submit subject details to the Global Email Insights variant for processing.

JSON

{
  "resourceId": "<resourceId>",
  "context": {
    "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 a very high fraud risk returned a Not Verified outcome.

JSON

{
  "response": {
    "advice": {
      "contains": {
        "domain_country_code": "US",
        "fraud_risk": "VERY_HIGH",
        "fraud_risk_score": 930,
        "email_fraud_type": "FRAUD",
        "email_fraud_signals": [
          "FRAUD",
          "DISPOSABLE",
          "DOMAIN"
        ],
        "email_risks": [],
        "email_exists": true,
        "domain_exists": true,
        "email_total_hits": 29,
        "email_unique_hits": 1
      }
    },
    "outcome": "Not Verified"
  }
}

Global Email Validation

Global Email Validation variant helps customers first confirm that an email exists before running email insight variants.

Capabilities

This variant returns a single capability: a generic email match result.

Generic email match result

This capability indicates whether the email address matched.

Value	Description
match	The email address matched.
mismatch	The email address didn’t match.
not available	No match data was available.
unrecognised value	The service returned a value that couldn’t be recognised.
no result	No result was returned for the email address.

Default outcomes

Outcome	Condition	Description
Email Valid	Email match result is match	The email address exists.
Email Invalid	Email match result is mismatch	The email address doesn’t exist.
Could Not Locate	Default (no conditions matched)	The email address couldn’t be located.
Error	—	—

Input payload

The following is a sample payload used to submit an email address to the Global Email Validation variant for processing. This variant needs only a personal email address.

JSON

{
  "resourceId": "<resourceId>",
  "context": {
    "subject": {
      "identity": {
        "emails": [
          {
            "type": "other",
            "email": "[e-mail]"
          }
        ]
      }
    }
  }
}

Field	Required	Description
identity.emails[].type	Yes	Type of email address, for example "other".
identity.emails[].email	Yes	Email address of the subject.

Sample response

The following is a sample response for a valid email address.

JSON

{
  "response": {
    "advice": {
      "contains": {}
    },
    "outcome": "Email Valid"
  }
}