Email Deliverability Check (SPF, DKIM, DMARC, MX, Blacklists by Domain)

{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string"
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "properties": {
    "spf": {
      "type": "object",
      "properties": {
        "valid": {
          "type": "boolean"
        },
        "exists": {
          "type": "boolean"
        },
        "record": {
          "type": "string",
          "description": "The raw SPF DNS TXT record."
        },
        "mechanism": {
          "type": "string",
          "description": "Human-readable summary of the record's terminal mechanism, e.g. '~all (soft fail)', '-all (hard fail)'."
        }
      },
      "additionalProperties": true
    },
    "dkim": {
      "type": "object",
      "properties": {
        "detected": {
          "type": "boolean"
        },
        "selector_found": {
          "type": [
            "string",
            "null"
          ],
          "description": "The DKIM selector found, or null when no DKIM record was detected."
        }
      },
      "additionalProperties": true
    },
    "dmarc": {
      "type": "object",
      "properties": {
        "exists": {
          "type": "boolean"
        },
        "policy": {
          "type": "string",
          "description": "e.g. 'reject'."
        },
        "record": {
          "type": "string",
          "description": "The raw DMARC DNS TXT record, published by the domain owner for anyone to query over DNS. May embed a `rua=mailto:` reporting address that the domain owner chose to publish publicly for aggregate-report delivery."
        }
      },
      "additionalProperties": true
    },
    "grade": {
      "type": "string",
      "description": "Letter grade derived from score. Observed: 'A', 'B'."
    },
    "score": {
      "type": "number",
      "description": "0-100 deliverability score. Observed: 80, 100."
    },
    "domain": {
      "type": "string",
      "description": "The domain that was checked."
    },
    "issues": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Plain-language problems found. Empty when the domain has no issues (observed on a fully-configured domain)."
    },
    "mx_records": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "exchange": {
            "type": "string"
          },
          "priority": {
            "type": "number"
          }
        },
        "additionalProperties": true
      },
      "description": "The domain's mail exchange records. One fixture shows a single real MX host; the other shows a single entry with an empty exchange string and priority 0 for a domain with no real mail server -- an empty `exchange` does not mean the array itself is empty."
    },
    "blacklisted": {
      "type": "boolean",
      "description": "True if the domain appears on any checked blacklist."
    },
    "recommendations": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Plain-language fixes for each issue. Empty when `issues` is empty."
    },
    "blacklists_checked": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "listed": {
            "type": "boolean"
          }
        },
        "additionalProperties": true
      },
      "description": "3 entries on both real calls observed (zen.spamhaus.org, bl.spamcop.net, b.barracudacentral.org)."
    }
  },
  "description": "The deliverability report, as returned at routing.responseResultPath ($.output).",
  "additionalProperties": false
}