{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/groundmail-dev/json-schema/groundmail-dev-dmarc-response-schema.json",
  "title": "DmarcResponse",
  "x-generated": "2026-11-10",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/groundmail-dev-dmarc-api-openapi.yml#/components/schemas/DmarcResponse",
  "type": "object",
  "required": [
    "dmarc"
  ],
  "properties": {
    "dmarc": {
      "$ref": "#/$defs/DmarcMonitoring"
    }
  },
  "$defs": {
    "DmarcMonitoring": {
      "type": "object",
      "required": [
        "domain",
        "enabled"
      ],
      "properties": {
        "domain": {
          "type": "string"
        },
        "enabled": {
          "type": "boolean"
        },
        "status": {
          "type": "string",
          "enum": [
            "waiting",
            "receiving",
            "disabled"
          ],
          "description": "waiting until the first report arrives"
        },
        "report_address": {
          "type": "string"
        },
        "rua": {
          "type": "string"
        },
        "dns": {
          "type": "object",
          "properties": {
            "host": {
              "type": "string"
            },
            "record": {
              "type": [
                "string",
                "null"
              ]
            },
            "rua_present": {
              "type": "boolean"
            },
            "policy": {
              "type": [
                "string",
                "null"
              ]
            },
            "suggested_record": {
              "type": "string",
              "description": "The record to publish"
            }
          }
        },
        "digest_enabled": {
          "type": "boolean"
        },
        "created_at": {
          "type": "string",
          "format": "date-time"
        },
        "last_report_at": {
          "type": [
            "string",
            "null"
          ],
          "format": "date-time"
        },
        "window_days": {
          "type": "integer"
        },
        "summary": {
          "type": "object",
          "properties": {
            "messages": {
              "type": "integer"
            },
            "dmarc_pass": {
              "type": "integer"
            },
            "dmarc_fail": {
              "type": "integer"
            },
            "pass_rate": {
              "type": "number"
            },
            "reports": {
              "type": "integer"
            },
            "reporters": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        },
        "sources": {
          "type": "array",
          "items": {
            "$ref": "#/$defs/DmarcSource"
          }
        },
        "daily": {
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "date": {
                "type": "string",
                "format": "date"
              },
              "messages": {
                "type": "integer"
              },
              "dmarc_pass": {
                "type": "integer"
              },
              "pass_rate": {
                "type": "number"
              }
            }
          }
        },
        "readiness": {
          "type": "object",
          "properties": {
            "verdict": {
              "type": "string",
              "enum": [
                "no_data",
                "collecting",
                "fix_sources",
                "ready_quarantine",
                "ready_reject",
                "enforced"
              ]
            },
            "label": {
              "type": "string"
            },
            "detail": {
              "type": "string"
            },
            "days_of_data": {
              "type": "integer"
            },
            "blocking_sources": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          }
        }
      }
    },
    "DmarcSource": {
      "type": "object",
      "properties": {
        "key": {
          "type": "string",
          "description": "Provider id (google, microsoft, groundmail, sendgrid…) or unknown:<reverse DNS domain>"
        },
        "provider": {
          "type": "string"
        },
        "name": {
          "type": "string"
        },
        "status": {
          "type": "string",
          "enum": [
            "passing",
            "failing",
            "unknown"
          ],
          "description": "unknown is an unrecognised server failing DMARC (possible spoofing)"
        },
        "messages": {
          "type": "integer"
        },
        "dmarc_pass": {
          "type": "integer"
        },
        "pass_rate": {
          "type": "number",
          "description": "0 to 1"
        },
        "spf_aligned_rate": {
          "type": "number"
        },
        "dkim_aligned_rate": {
          "type": "number"
        },
        "ips": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Up to five source IPs, busiest first"
        },
        "ip_count": {
          "type": "integer"
        },
        "first_seen": {
          "type": "string",
          "format": "date-time"
        },
        "last_seen": {
          "type": "string",
          "format": "date-time"
        }
      }
    }
  }
}