Overview

Use this method to retrieve email confirmation check results.

Required permissions

To use this method, your app token must have the View check results permission.

Request example

curl -X GET \
     'https://api.sumsub.com/resources/checks/latest?type=EMAIL_CONFIRMATION' \
     -H 'X-App-Token: <your-app-token>' \
     -H 'X-App-Access-Sig: <your-signature>' \
     -H 'X-App-Access-Ts: <unix-timestamp>'

Response explained

The response represents a singleton list of checks.

• Root variables
  • emailConfirmationCheckInfo attributes
  • Email risk labels
• Response example

Root variables

The root variables are the core check result data items. Some of them may include nested attributes and element fields.

emailConfirmationCheckInfo attributes

The following table explains the emailConfirmationCheckInfo attributes that represent the check results of the provided email address in accordance with specific parameters.

intelligence attributes

The intelligence object shows how the email address has been used, based on the Sumsub network. The data comes from the address being used across online services. Your data on users and their links to identities is not shared in the network.

• We recommend using these fields as features in risk assessment and machine learning models that combine many signals, not as a single flag for making decisions.
• If there is no history for the address, the field is not returned. A missing field means never observed, not zero, or low activity. The whole intelligence object may be missing.

Available email risk labels

The following table explains possible email risk labels assigned in accordance with the check results.

Response example

{
  "checks": [
    {
      "answer": "RED",
      "checkType": "EMAIL_CONFIRMATION",
      "createdAt": "2022-08-25 12:01:11",
      "id": "300e3be1-61cc-48ce-9eda-000000000000",
      "emailConfirmationCheckInfo": {
        "riskScore": 72,
        "firstSeenAt": "2021-05-17 07:30:15",
        "email": "[email protected]",
        "confirmedViaOtp": null,
        "nonDisposable": "GREEN",
        "riskLevel": "RED",
        "websiteExists": "GREEN",
        "deliverable": "GREEN",
        "webRegistrationsExist": "GREEN",
        "profiles": [
          "google",
          "facebook",
          "amazon",
          "spotify",
          "duolingo"
        ],
        "leaked": true,
        "breachesCnt": 3,
        "riskLabels": [
          "highRisk",
          "plusAddressing"
        ],
        "intelligence": {
          "firstSeenDays": 1265,
          "activityIndex": 4,
          "diversityIndex": 1
        }
      }
    }
  ]
}