Get email confirmation check results

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.

FieldTypeDescription
answerStringCheck answer:
  • RED — at least one of the checks returned a high risk indication.
  • YELLOW — all the checks ended up with no certain data found.
  • GREEN — at least one of the checks ended up green with no high risk indication; some YELLOW results are acceptable.
checkTypeStringIndicates this is the EMAIL_CONFIRMATION check type.
createdAtDateDate and time (UTC) of the latest email confirmation check result.
idStringUnique identifier of the check.
emailConfirmationCheckInfoObjectIncludes specific email check parameters with check results.

emailConfirmationCheckInfo attributes

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

FieldTypeDescription
firstSeenAtDateDate and time the email address was first used somewhere to identify its owner. For example, as a login on a web site.
emailStringApplicant email address.
confirmedViaOtpStringIndicates 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.
nonDisposableStringIndicates whether the provided email address is a temporary one and might disappear after a short period of time.
  • GREEN — permanent email address.
  • YELLOW — not enough data found.
  • RED — disposable email address.
riskLevelStringIndicates a verdict made by the system according to the check results and internal logic.
  • GREEN — no risk.
  • YELLOW — medium risk.
  • RED — high risk.
suspiciousEmailStringIndicates the credibility of the provided email address.
  • GREEN — credible email address.
  • YELLOW — no certain data found.
  • RED — high risk (for example, suspected in spamming).
blacklistedStringIndicates whether the provided email address is included in the known global blocklists.
  • GREEN — not found in blocklists.
  • YELLOW — no certain data found.
  • RED — found in blocklists.
websiteExistsStringIndicates the email domain existence.
  • GREEN — email domain exists.
  • YELLOW — no certain data found.
  • RED — email domain does not exist.
deliverableStringIndicates whether messages can be delivered to the specified email address.
  • GREEN — messages can be delivered.
  • YELLOW — no certain data found.
  • RED — messages are not delivered.
webRegistrationsExistStringIndicates if the email address is used for registration on websites.
  • GREEN — email address is used for registrations.
  • YELLOW — no certain data found.
  • RED — email address was never used for registration.
profilesArray of stringsInformation on profiles created for social networks, services, and other platforms using the provided email address.
riskLabelsArray of stringsA 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 labelDescription
mediumRiskMedium-risk email address.
A verdict made by the system according to the check results and internal logic.
highRiskHigh-risk email address.
A verdict made by the system according to the check results and internal logic.
disposableTemporary email address which is provided by a disposable email service and usually expires in a few minutes.
noWebRegistrationsEmail registration on websites is not detected.
noWebsiteExistsEmail domain does not exist.
nonDeliverableMessages fail to be delivered to this email address.
invalidEmailEmail 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
      }
    }
  ]
}
Language
Credentials
Header
Click Try It! to start a request and see the response here!