Email Address Validator (Syntax, MX, Disposable & Role Checks)

{
  "type": "object",
  "required": [
    "emails"
  ],
  "properties": {
    "emails": {
      "type": "string",
      "description": "comma-separated email addresses, up to 25 per call (a single address works too)"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of addresses validated in this call."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string",
            "description": "Typically the literal string 'email_validation'."
          },
          "email": {
            "type": "string",
            "description": "The address as submitted, echoed back exactly as given in the input."
          },
          "domain": {
            "type": "string",
            "description": "The portion of the address after the '@'."
          },
          "mxFound": {
            "type": "boolean",
            "description": "True when the domain has at least one resolvable MX record."
          },
          "reasons": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Human-readable reason strings behind the verdict."
          },
          "verdict": {
            "type": "string",
            "description": "Confirmed as 'risky' in testing (a role account and a disposable domain). The endpoint's own documentation also describes 'ok' and 'invalid' verdicts, but neither has been seen in a real call -- treat those two as documented-but-unconfirmed rather than guaranteed values."
          },
          "localPart": {
            "type": "string",
            "description": "The portion of the address before the '@'."
          },
          "mxRecords": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "host": {
                  "type": "string"
                },
                "priority": {
                  "type": "number"
                }
              },
              "additionalProperties": true
            },
            "description": "The domain's mail-exchange hosts. Empty when mxFound is false."
          },
          "normalized": {
            "type": "string",
            "description": "The address after normalization -- typically identical to `email` (no case-folding or alias-stripping difference has been seen)."
          },
          "roleAccount": {
            "type": "boolean",
            "description": "True for a generic mailbox local part (e.g. 'support', 'sales', 'info') rather than an individual's own address."
          },
          "syntaxValid": {
            "type": "boolean"
          },
          "freeProvider": {
            "type": "boolean",
            "description": "True when the domain is a known free consumer email provider."
          },
          "disposableDomain": {
            "type": "boolean",
            "description": "True when the domain matches a known throwaway/disposable list."
          }
        },
        "additionalProperties": true
      }
    }
  },
  "description": "The validation batch.",
  "additionalProperties": true
}