get https://api.sumsub.com/resources/checks/latest?type=EMAIL_CONFIRMATION
Overview
Use this method to retrieve email confirmation check results.
Response explained
The response represents a singleton list of checks.
Root variables
The root variables are the core check result data items. Some of them may include nested attributes and element fields.
Field | Type | Description |
---|---|---|
answer | String | Check answer:
|
checkType | String | Indicates this is the EMAIL_CONFIRMATION check type. |
createdAt | Date | Date and time (UTC) of the latest email confirmation check result. |
id | String | Unique identifier of the check. |
emailConfirmationCheckInfo | Object | Includes specific email check parameters with check results. |
emailConfirmationCheckInfo
attributes
emailConfirmationCheckInfo
attributesThe following table explains the emailConfirmationCheckInfo
attributes that represent the check results of the provided email address in accordance with specific parameters.
Field | Type | Description |
---|---|---|
firstSeenAt | Date | Date and time the email address was first used somewhere to identify its owner. For example, as a login on a web site. |
email | String | Applicant email address. |
confirmedViaOtp | String | Indicates if the email address is confirmed by the applicant via OTP (One Time Password).GREEN means that the applicant received a confirmation code by email and confirmed it via SDK, null — if not. |
nonDisposable | String | Indicates whether the provided email address is a temporary one and might disappear after a short period of time.
|
riskLevel | String | Indicates a verdict made by the system according to the check results and internal logic.
|
suspiciousEmail | String | Indicates the credibility of the provided email address.
|
blacklisted | String | Indicates whether the provided email address is included in the known global blocklists.
|
websiteExists | String | Indicates the email domain existence.
|
deliverable | String | Indicates whether messages can be delivered to the specified email address.
|
webRegistrationsExist | String | Indicates if the email address is used for registration on websites.
|
profiles | Array of strings | Information on profiles created for social networks, services, and other platforms using the provided email address. |
riskLabels | Array of strings | A list of email risk labels assigned by the system according to the check results and internal logic. |
Available email risk labels
The following table explains possible email risk labels assigned in accordance with the check results.
Risk label | Description |
---|---|
mediumRisk | Medium-risk email address. A verdict made by the system according to the check results and internal logic. |
highRisk | High-risk email address. A verdict made by the system according to the check results and internal logic. |
disposable | Temporary email address which is provided by a disposable email service and usually expires in a few minutes. |
noWebRegistrations | Email registration on websites is not detected. |
noWebsiteExists | Email domain does not exist. |
nonDeliverable | Messages fail to be delivered to this email address. |
invalidEmail | Email address is invalid. |
Response example
{
"checks": [
{
"answer": "RED",
"checkType": "EMAIL_CONFIRMATION",
"createdAt": "2022-08-25 12:01:11",
"id": "300e3be1-61cc-48ce-9eda-000000000000",
"emailConfirmationCheckInfo": {
"firstSeenAt": "2021-05-17 07:30:15",
"email": "[email protected]",
"confirmedViaOtp": null,
"nonDisposable": "YELLOW",
"riskLevel": "YELLOW",
"suspiciousEmail": "RED",
"blacklisted": "GREEN",
"websiteExists": "YELLOW",
"deliverable": "YELLOW",
"webRegistrationsExist": "YELLOW",
"profiles": null,
"riskLabels": null
}
}
]
}