VerificationResult

Result of a single email-address verification call against the Email Verifier API 16-point engine.

Email VerificationDeliverabilitySMTP CheckBounce PreventionLead ValidationDisposable DetectionSpam Trap DetectionCatch-All DetectionGreylistingRole Account DetectionTypo SuggestionB2B Lead Scoring

Properties

Name	Type	Description
status	string	Top-level deliverability verdict.
event	string	Fine-grained event code returned by the verification engine.
details	string	Human-readable explanation of the event.
email	string	Email address verified.
emailSuggested	stringnull	Suggested correction when a domain typo is detected.
mailbox	string	Local part of the verified address.
domain	string	Domain part of the verified address.
mxIp	string	IPv4 address of the resolved mail exchange server.
mxLocation	string	ISO 3166-1 alpha-2 country code of the MX server.
possibleSpamtrap	boolean	Address matches known honeypot or spam-trap patterns.
isComplainer	boolean	Address belongs to a known frequent spam complainer.
isDisposable	boolean	Address belongs to a disposable / burner provider.
isFreeService	boolean	Address is on a free consumer mailbox provider.
isOffensive	boolean	Address contains offensive language.
isRoleAccount	boolean	Address is a role / departmental alias.
isGibberish	boolean	Local part appears to be machine-generated.
remaining	string	Customer credit balance remaining after the request.
execution	number	Wall-clock execution time in seconds.

View JSON Schema on GitHub

JSON Schema

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/email-verifier-api/main/json-schema/email-verifier-api-verification-result-schema.json",
  "title": "VerificationResult",
  "description": "Result of a single email-address verification call against the Email Verifier API 16-point engine.",
  "type": "object",
  "required": [
    "status",
    "event",
    "details",
    "email",
    "mailbox",
    "domain",
    "remaining",
    "execution"
  ],
  "properties": {
    "status": {
      "type": "string",
      "description": "Top-level deliverability verdict.",
      "enum": ["passed", "failed", "unknown", "transient"]
    },
    "event": {
      "type": "string",
      "description": "Fine-grained event code returned by the verification engine.",
      "enum": [
        "mailboxExists",
        "mailboxDoesNotExist",
        "mailboxIsFull",
        "domainDoesNotExist",
        "mxServerDoesNotExist",
        "invalidSyntax",
        "isCatchall",
        "isGreylisting",
        "transientError"
      ]
    },
    "details": { "type": "string", "description": "Human-readable explanation of the event." },
    "email": { "type": "string", "format": "email", "description": "Email address verified." },
    "emailSuggested": {
      "type": ["string", "null"],
      "description": "Suggested correction when a domain typo is detected."
    },
    "mailbox": { "type": "string", "description": "Local part of the verified address." },
    "domain": { "type": "string", "description": "Domain part of the verified address." },
    "mxIp": { "type": "string", "description": "IPv4 address of the resolved mail exchange server." },
    "mxLocation": { "type": "string", "description": "ISO 3166-1 alpha-2 country code of the MX server." },
    "possibleSpamtrap": { "type": "boolean", "description": "Address matches known honeypot or spam-trap patterns." },
    "isComplainer": { "type": "boolean", "description": "Address belongs to a known frequent spam complainer." },
    "isDisposable": { "type": "boolean", "description": "Address belongs to a disposable / burner provider." },
    "isFreeService": { "type": "boolean", "description": "Address is on a free consumer mailbox provider." },
    "isOffensive": { "type": "boolean", "description": "Address contains offensive language." },
    "isRoleAccount": { "type": "boolean", "description": "Address is a role / departmental alias." },
    "isGibberish": { "type": "boolean", "description": "Local part appears to be machine-generated." },
    "remaining": { "type": "string", "description": "Customer credit balance remaining after the request." },
    "execution": { "type": "number", "description": "Wall-clock execution time in seconds." }
  }
}