EmailResult

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/layercall-com/json-schema/layercall-com-email-result-schema.json",
  "title": "EmailResult",
  "x-generated": "2026-10-31",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/layercall-com-openapi.json#/components/schemas/EmailResult",
  "type": "object",
  "required": [
    "email",
    "risk_score",
    "verdict"
  ],
  "properties": {
    "email": {
      "type": "string"
    },
    "normalized_email": {
      "type": "string"
    },
    "risk_score": {
      "$ref": "#/$defs/RiskScore"
    },
    "verdict": {
      "$ref": "#/$defs/Verdict"
    },
    "status": {
      "type": "string",
      "description": "e.g. valid, invalid, do_not_mail, unknown."
    },
    "sub_status": {
      "type": [
        "string",
        "null"
      ],
      "description": "e.g. disposable, role_based, mailbox_not_found."
    },
    "deliverability_score": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    },
    "did_you_mean": {
      "type": [
        "string",
        "null"
      ],
      "description": "Suggested correction for a likely typo."
    },
    "signals": {
      "type": "object",
      "properties": {
        "syntax_valid": {
          "type": "boolean"
        },
        "mx_found": {
          "type": "boolean"
        },
        "is_disposable": {
          "type": "boolean"
        },
        "is_homograph": {
          "type": "boolean",
          "description": "Lookalike domain — mixed script or a spelling that folds onto a real ASCII domain."
        },
        "is_role_account": {
          "type": "boolean"
        },
        "is_free_provider": {
          "type": "boolean"
        }
      }
    },
    "cached": {
      "type": "boolean"
    },
    "request_id": {
      "type": "string"
    },
    "signals_unavailable": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Signals that could not be measured on this request — e.g. [\"tor\", \"vpn_providers\"]. Absent entirely when every feed answered, so the happy-path shape is unchanged. Present means the score was built on incomplete data: a \"clean\" answer and a \"we could not check\" answer are otherwise identical."
    },
    "domain": {
      "type": "string"
    },
    "domain_age_days": {
      "nullable": true
    },
    "mx_provider": {
      "type": "string"
    },
    "mx_records": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "first_seen": {
      "nullable": true
    },
    "times_seen": {
      "type": "integer"
    },
    "abuse_reports": {
      "type": "integer"
    },
    "digital_footprint": {
      "type": "object",
      "properties": {
        "has_gravatar": {
          "type": [
            "boolean",
            "null"
          ],
          "description": "Whether the address has a public Gravatar. null means the check did not run — the request's time budget was exhausted — which is not the same as no avatar."
        },
        "gravatar_profile_url": {
          "nullable": true
        },
        "breach_count": {
          "nullable": true
        },
        "seen_in_breach": {
          "nullable": true
        }
      }
    },
    "processing_time_sec": {
      "type": "number"
    },
    "billable_lookups": {
      "type": "integer"
    }
  },
  "$defs": {
    "RiskScore": {
      "type": "integer",
      "minimum": 0,
      "maximum": 100,
      "description": "0 = clean, 100 = certain fraud."
    },
    "Verdict": {
      "type": "string",
      "enum": [
        "allow",
        "review",
        "block"
      ],
      "description": "Recommended action. Thresholds move with `strictness`."
    }
  }
}