> ## 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.

## Global Email Validation and Fraud Insights (Legacy)

This variant validates email addresses globally and returns both a pass/fail verification result and detailed risk codes.

**Required inputs:** Full name, 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.

### 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": "<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"
  }
}
```