VerificationResult

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/emailverifier-dev/json-schema/emailverifier-dev-verification-result-schema.json",
  "title": "VerificationResult",
  "x-generated": "2026-10-30",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/emailverifier-dev-openapi.json#/components/schemas/VerificationResult",
  "type": "object",
  "required": [
    "email",
    "status",
    "action",
    "flagged",
    "signals",
    "suggestion"
  ],
  "additionalProperties": false,
  "properties": {
    "email": {
      "type": "string"
    },
    "status": {
      "type": "string",
      "enum": [
        "deliverable",
        "risky",
        "undeliverable",
        "unknown"
      ],
      "description": "Deliverable means the server accepted the recipient, not guaranteed delivery or proof the mailbox exists. Catch-all acceptance remains deliverable/review with the catch_all_domain signal. Risky includes disposable addresses. Unknown means evidence is incomplete or conflicting."
    },
    "action": {
      "type": "string",
      "enum": [
        "block",
        "allow",
        "review"
      ],
      "description": "Recommended default handling. Allow can accompany an unknown status when the available evidence supports accepting the address; it does not confirm current delivery or ownership. Review preserves uncertain addresses such as catch-all domains without blocking them."
    },
    "flagged": {
      "type": "boolean",
      "description": "True when the recommended action is block; false when it is allow or review."
    },
    "signals": {
      "type": "array",
      "description": "invalid_syntax: The address format is invalid.\n\ninvalid_domain: The domain format is invalid.\n\nno_mail_server: The domain has no usable mail routing.\n\ndisposable_address: This domain provides disposable email addresses.\n\nfree_provider: This is a personal email provider.\n\nrole_address: This is a shared role address, such as support or sales.\n\nmailbox_accepts_mail: The mail server accepted this recipient during the check. Delivery is not guaranteed.\n\nmailbox_rejected: The mail server explicitly rejected this recipient as nonexistent.\n\ncatch_all_domain: The server also accepted a random address. This mailbox could not be confirmed.\n\npossible_typo: The domain may contain a typo. Check the suggested address.\n\nverification_inconclusive: The available evidence could not confirm or reject this mailbox.\n\ncatch_all_check_inconclusive: The server accepted the recipient, but the catch-all check could not finish conclusively.\n\ndns_unavailable: The mail-routing DNS lookup could not finish. Try again later.\n\nsmtp_timeout: The mail server did not respond in time. Try again later.\n\nsmtp_connection_failed: The connection to the mail server could not finish. Try again later.\n\nsmtp_temporary_failure: The mail server temporarily deferred the check. Try again later.\n\nsmtp_policy_block: The mail server restricted the check. This does not mean the address is invalid.\n\nsmtp_cannot_verify: The mail server could not confirm this recipient.\n\nsmtp_conflict: The mail servers returned conflicting evidence. This mailbox could not be confirmed.\n\nverification_unavailable: Mailbox verification is temporarily unavailable. Try again later.",
      "items": {
        "type": "string",
        "enum": [
          "invalid_syntax",
          "invalid_domain",
          "no_mail_server",
          "disposable_address",
          "free_provider",
          "role_address",
          "mailbox_accepts_mail",
          "mailbox_rejected",
          "catch_all_domain",
          "possible_typo",
          "verification_inconclusive",
          "catch_all_check_inconclusive",
          "dns_unavailable",
          "smtp_timeout",
          "smtp_connection_failed",
          "smtp_temporary_failure",
          "smtp_policy_block",
          "smtp_cannot_verify",
          "smtp_conflict",
          "verification_unavailable"
        ]
      }
    },
    "suggestion": {
      "type": [
        "string",
        "null"
      ],
      "description": "Corrected address for a recognized provider typo."
    }
  }
}