EmailValidation

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://raw.githubusercontent.com/api-evangelist/twilio/main/json-schema/twilio-email-validation-schema.json",
  "title": "EmailValidation",
  "x-generated": "2026-10-08",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/twilio-email-validation-api-openapi.yml#/components/schemas/EmailValidation",
  "type": "object",
  "properties": {
    "result": {
      "type": "object",
      "properties": {
        "email": {
          "type": "string",
          "format": "email"
        },
        "verdict": {
          "type": "string",
          "enum": [
            "Valid",
            "Risky",
            "Invalid"
          ]
        },
        "score": {
          "type": "number",
          "minimum": 0,
          "maximum": 1,
          "description": "Confidence score (0 to 1)"
        },
        "local": {
          "type": "string",
          "description": "Local part of the email"
        },
        "host": {
          "type": "string",
          "description": "Domain part of the email"
        },
        "suggestion": {
          "type": "string",
          "description": "Suggested correction if applicable"
        },
        "has_mx_or_a_record": {
          "type": "boolean"
        },
        "checks": {
          "type": "object",
          "properties": {
            "domain": {
              "type": "object",
              "properties": {
                "has_valid_address_syntax": {
                  "type": "boolean"
                },
                "has_mx_or_a_record": {
                  "type": "boolean"
                },
                "is_suspected_disposable_address": {
                  "type": "boolean"
                }
              }
            },
            "local_part": {
              "type": "object",
              "properties": {
                "is_suspected_role_address": {
                  "type": "boolean"
                }
              }
            },
            "additional": {
              "type": "object",
              "properties": {
                "has_known_bounces": {
                  "type": "boolean"
                },
                "has_suspected_bounces": {
                  "type": "boolean"
                }
              }
            }
          }
        },
        "ip_address": {
          "type": "string",
          "description": "IP address used for validation"
        }
      }
    }
  }
}