{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "$id": "https://artifacts.apis.io/mandiant/json-schema/mandiant-finding-schema.json",
  "title": "Finding",
  "description": "A ‘stateless’ and a point in time event that a check produced a result of interest.",
  "x-generated": "2026-11-12",
  "x-method": "derived",
  "x-generator": "derive-json-schema.py",
  "x-source": "openapi/mandiant-projects-api-openapi.yml#/components/schemas/Finding",
  "properties": {
    "reoccurrenceTimes": {
      "readOnly": true,
      "type": "array",
      "items": {
        "type": "string",
        "format": "google-datetime"
      },
      "description": "Output only. When identical finding (same labels and same details) has re-occurred."
    },
    "severity": {
      "type": "number",
      "format": "float",
      "description": "Optional. Deprecated: Use the `severity_analysis` field instead. Base severity score from the finding source.",
      "deprecated": true
    },
    "severityAnalysis": {
      "$ref": "#/$defs/SeverityAnalysis",
      "description": "Output only. High-Precision Severity Analysis verdict for the finding."
    },
    "detail": {
      "$ref": "#/$defs/FindingDetail",
      "description": "Required. Holder of the domain specific details of the finding."
    },
    "alert": {
      "type": "string",
      "description": "Optional. Name of the alert that this finding is bound to."
    },
    "audit": {
      "$ref": "#/$defs/Audit",
      "description": "Output only. Audit data about the finding."
    },
    "aiSummary": {
      "type": "string",
      "description": "Optional. AI summary of the finding."
    },
    "configurations": {
      "description": "Optional. Configuration names that are bound to this finding.",
      "items": {
        "type": "string"
      },
      "type": "array"
    },
    "provider": {
      "type": "string",
      "description": "Required. Logical source of this finding (name of the sub-engine)."
    },
    "displayName": {
      "description": "Required. A short descriptive title for the finding <= 250 chars. EX: \"Actor 'baddy' offering $1000 for credentials of 'goodguy'\".",
      "type": "string"
    },
    "name": {
      "type": "string",
      "description": "Identifier. Server generated name for the finding (leave clear during creation). Format: projects/{project}/findings/{finding}"
    },
    "relevanceAnalysis": {
      "$ref": "#/$defs/RelevanceAnalysis",
      "description": "Output only. High-Precision Relevance Analysis verdict for the finding."
    }
  },
  "type": "object",
  "$defs": {
    "AVDetections": {
      "type": "object",
      "description": "Details about the detection vendors.",
      "properties": {
        "detectedVendorCount": {
          "description": "Optional. Number of vendors that detected the threat.",
          "format": "int32",
          "type": "integer"
        },
        "totalVendorCount": {
          "type": "integer",
          "description": "Optional. Total number of vendors.",
          "format": "int32"
        }
      }
    },
    "Association": {
      "description": "Represents an association with a vulnerability.",
      "type": "object",
      "properties": {
        "type": {
          "type": "string",
          "enum": [
            "THREAT_INTEL_OBJECT_TYPE_UNSPECIFIED",
            "THREAT_INTEL_OBJECT_TYPE_THREAT_ACTOR",
            "THREAT_INTEL_OBJECT_TYPE_MALWARE",
            "THREAT_INTEL_OBJECT_TYPE_REPORT",
            "THREAT_INTEL_OBJECT_TYPE_CAMPAIGN",
            "THREAT_INTEL_OBJECT_TYPE_IOC_COLLECTION",
            "THREAT_INTEL_OBJECT_TYPE_SOFTWARE_AND_TOOLKITS",
            "THREAT_INTEL_OBJECT_TYPE_VULNERABILITY"
          ],
          "description": "Required. The type of the association."
        },
        "id": {
          "type": "string",
          "description": "Required. The ID of the association."
        }
      }
    },
    "Audit": {
      "type": "object",
      "properties": {
        "updateTime": {
          "type": "string",
          "readOnly": true,
          "format": "google-datetime",
          "description": "Output only. Time of creation or last update."
        },
        "creator": {
          "type": "string",
          "description": "Output only. Agent that created or updated the record, could be a UserId or a JobId.",
          "readOnly": true
        },
        "updater": {
          "description": "Output only. Agent that last updated the record, could be a UserId or a JobId.",
          "type": "string",
          "readOnly": true
        },
        "createTime": {
          "format": "google-datetime",
          "description": "Output only. Time of creation.",
          "readOnly": true,
          "type": "string"
        }
      },
      "description": "Tracks basic CRUD facts."
    },
    "CertificateDetails": {
      "type": "object",
      "properties": {
        "issuer": {
          "type": "string",
          "description": "Optional. The SSL certificate issuer."
        },
        "subjectAlternativeNames": {
          "description": "Optional. The SSL subject alternative names.",
          "type": "array",
          "items": {
            "type": "string"
          }
        }
      },
      "description": "Details regarding the SSL certificate configuration."
    },
    "CommunicationContext": {
      "description": "Detailed communication context metadata for documents originating from deep and dark web communication channels.",
      "properties": {
        "channelUrl": {
          "description": "Optional. URL of the communication channel.",
          "type": "string"
        },
        "messageId": {
          "type": "string",
          "description": "Optional. Message or post identifier on the originating platform."
        },
        "channelDescription": {
          "type": "string",
          "description": "Optional. Description of the communication channel."
        },
        "serviceName": {
          "description": "Optional. Service from the collection event origin (e.g. forum or chat service name).",
          "type": "string"
        },
        "channelPath": {
          "type": "string",
          "description": "Optional. Channel path (e.g. forum path or sub-channel)."
        },
        "threadId": {
          "description": "Optional. Conversation thread identifier.",
          "type": "string"
        },
        "channelName": {
          "type": "string",
          "description": "Optional. Name of the communication channel."
        }
      },
      "type": "object"
    },
    "DataLeakFindingDetail": {
      "type": "object",
      "description": "A detail object for a Data Leak finding.",
      "properties": {
        "severity": {
          "enum": [
            "SEVERITY_UNSPECIFIED",
            "LOW",
            "MEDIUM",
            "HIGH",
            "CRITICAL"
          ],
          "type": "string",
          "description": "Required. The severity of the Data Leak finding. This indicates the potential impact of the threat."
        },
        "discoveryDocument": {
          "$ref": "#/$defs/DiscoveryDocument",
          "description": "Optional. The discovery document associated with the Data Leak finding."
        },
        "documentId": {
          "type": "string",
          "description": "Optional. Deprecated: Use `discovery_document` instead. The unique identifier of the document that triggered the Data Leak finding. This ID can be used to retrieve the content of the document for further analysis.",
          "deprecated": true
        },
        "matchScore": {
          "type": "number",
          "description": "Required. Reference to the match score of the Data Leak finding. This is a float value greater than 0 and less than or equal to 1 calculated by the matching engine based on the similarity of the document and the user provided configurations.",
          "format": "float"
        }
      }
    },
    "DiscoveryDocument": {
      "description": "Replaces the raw string ID to hold associated metadata.",
      "properties": {
        "documentId": {
          "readOnly": true,
          "type": "string",
          "description": "Output only. The identifier of the discovery document."
        },
        "communicationContext": {
          "$ref": "#/$defs/CommunicationContext",
          "description": "Optional. Detailed communication context metadata for documents originating from deep and dark web communication channels."
        },
        "documentType": {
          "description": "Output only. The classification/type of the document (e.g. `COMMUNICATION`, `DDW_COMMUNICATION`, `message`).",
          "readOnly": true,
          "type": "string"
        }
      },
      "type": "object"
    },
    "DnsRegistrationDetails": {
      "properties": {
        "registrantCountry": {
          "description": "Optional. The country code of the registrant (e.g., US). Use ISO 3166-1 alpha-2 codes",
          "type": "string"
        },
        "expireTime": {
          "description": "Optional. The specific timestamp when the current domain registration expires.",
          "type": "string",
          "format": "google-datetime"
        },
        "registrar": {
          "description": "Optional. The registrar where the domain was registered (e.g., NameCheap).",
          "type": "string"
        },
        "registrationTime": {
          "description": "Optional. The specific timestamp when the domain registration was created.",
          "type": "string",
          "format": "google-datetime"
        },
        "privateRegistration": {
          "description": "Optional. Indicates whether private registration is enabled on the WHOIS record.",
          "type": "boolean"
        }
      },
      "description": "Extracted WHOIS and DNS registration details of the domain.",
      "type": "object"
    },
    "DomainMonitoringDnsDetails": {
      "properties": {
        "retrievalTime": {
          "type": "string",
          "description": "Optional. The time the DNS details were retrieved.",
          "format": "google-datetime"
        },
        "dnsRecords": {
          "description": "Optional. The DNS records of the domain.",
          "items": {
            "$ref": "#/$defs/DomainMonitoringDnsRecord"
          },
          "type": "array"
        }
      },
      "description": "The DNS details of the domain.",
      "type": "object"
    },
    "DomainMonitoringDnsRecord": {
      "description": "The DNS record of the domain.",
      "type": "object",
      "properties": {
        "asnRegionCode": {
          "description": "Optional. The region code of the ASN. Use ISO 3166-1 alpha-2 codes.",
          "type": "string"
        },
        "asnHosting": {
          "type": "string",
          "description": "Optional. The ASN hosting the domain."
        },
        "ttl": {
          "description": "Optional. The TTL of the DNS record.",
          "format": "int32",
          "type": "integer"
        },
        "type": {
          "description": "Optional. The type of the DNS record.",
          "type": "string"
        },
        "resolvedIp": {
          "description": "Optional. The resolved IP address.",
          "type": "string"
        },
        "ipRegionCode": {
          "description": "Optional. The region code associated with the resolved IP. Use ISO 3166-1 alpha-2 codes.",
          "type": "string"
        },
        "recordData": {
          "description": "Optional. The value of the DNS record.",
          "type": "string"
        }
      }
    },
    "DomainMonitoringDomainDetails": {
      "description": "Details specific to a monitored domain.",
      "properties": {
        "domain": {
          "type": "string",
          "description": "Required. The domain name to match against."
        }
      },
      "type": "object"
    },
    "DomainMonitoringFindingDetail": {
      "properties": {
        "gtiDetails": {
          "$ref": "#/$defs/DomainMonitoringGtiDetails",
          "description": "Optional. The GTI details of the domain or URL."
        },
        "whoisDetails": {
          "$ref": "#/$defs/DomainMonitoringWhoIsDetails",
          "description": "Optional. The whois details of the domain or URL."
        },
        "registrationDetails": {
          "$ref": "#/$defs/DnsRegistrationDetails",
          "description": "Optional. Extracted WHOIS and DNS registration details."
        },
        "domainDetails": {
          "$ref": "#/$defs/DomainMonitoringDomainDetails",
          "description": "Details specific to a monitored domain."
        },
        "urlDetails": {
          "$ref": "#/$defs/DomainMonitoringUrlDetails",
          "description": "Details specific to a monitored URL."
        },
        "dnsDetails": {
          "$ref": "#/$defs/DomainMonitoringDnsDetails",
          "description": "Optional. The DNS details of the domain or URL."
        },
        "matchedDomain": {
          "type": "string",
          "description": "Optional. The matched domain."
        },
        "protectedBrand": {
          "description": "The protected brand name that triggered the alert.",
          "type": "string"
        },
        "relationships": {
          "$ref": "#/$defs/Relationships",
          "description": "Optional. The relationships of the domain or URL."
        },
        "infrastructure": {
          "$ref": "#/$defs/Infrastructure",
          "description": "Optional. The infrastructure of the domain or URL."
        },
        "threatAttributionDetails": {
          "$ref": "#/$defs/ThreatAttributionDetails",
          "description": "Optional. The threat attribution details of the domain or URL."
        },
        "protectedDomain": {
          "$ref": "#/$defs/DomainMonitoringDomainDetails",
          "description": "The protected domain that triggered the alert."
        }
      },
      "type": "object",
      "description": "A detailed object for a Domain or URL finding."
    },
    "DomainMonitoringGtiDetails": {
      "type": "object",
      "properties": {
        "gtiScore": {
          "format": "int32",
          "description": "Optional. The GTI score of the domain. The threat score is a number between 0 and 100.",
          "type": "integer"
        },
        "domainPermutation": {
          "description": "Optional. The permutation technique used for the domain (e.g., dictionary, homoglyph).",
          "type": "string"
        },
        "avDetections": {
          "$ref": "#/$defs/AVDetections",
          "description": "Optional. Detection counts across vendor feeds."
        },
        "verdict": {
          "readOnly": true,
          "enum": [
            "DOMAIN_MONITORING_GTI_VERDICT_UNSPECIFIED",
            "DOMAIN_MONITORING_GTI_VERDICT_BENIGN",
            "DOMAIN_MONITORING_GTI_VERDICT_UNDETECTED",
            "DOMAIN_MONITORING_GTI_VERDICT_SUSPICIOUS",
            "DOMAIN_MONITORING_GTI_VERDICT_MALICIOUS",
            "DOMAIN_MONITORING_GTI_VERDICT_UNKNOWN"
          ],
          "description": "Output only. The verdict of the domain.",
          "type": "string"
        },
        "threatClassification": {
          "description": "Optional. The threat classification of the domain, obtained from the domain report (e.g. DomainMonitoring).",
          "type": "string"
        },
        "gtiDomainUri": {
          "type": "string",
          "description": "Optional. The GTI link for the domain."
        }
      },
      "description": "The GTI details of the domain."
    },
    "DomainMonitoringUrlDetails": {
      "properties": {
        "url": {
          "type": "string",
          "description": "Required. The URL to match against."
        }
      },
      "description": "Details specific to a monitored URL.",
      "type": "object"
    },
    "DomainMonitoringWhoIsDetails": {
      "type": "object",
      "properties": {
        "retrievalTime": {
          "type": "string",
          "description": "Optional. The time the whois details were retrieved.",
          "format": "google-datetime"
        },
        "whois": {
          "description": "Optional. The whois details of the domain.",
          "type": "string"
        }
      },
      "description": "The whois details of the domain."
    },
    "Evidence": {
      "type": "object",
      "properties": {
        "distinctThemes": {
          "type": "array",
          "description": "A list of semantic themes or descriptions unique to one source or semantically distant.",
          "items": {
            "type": "string"
          }
        },
        "commonThemes": {
          "description": "A list of semantic themes or concepts found to be common, related, or aligned between the sources, supporting the verdict.",
          "items": {
            "type": "string"
          },
          "type": "array"
        }
      },
      "description": "Details the evidence used to determine the relevance verdict."
    },
    "FindingDetail": {
      "properties": {
        "dataLeak": {
          "$ref": "#/$defs/DataLeakFindingDetail",
          "description": "Data Leak finding detail type."
        },
        "insiderThreat": {
          "$ref": "#/$defs/InsiderThreatFindingDetail",
          "description": "Insider Threat finding detail type."
        },
        "initialAccessBroker": {
          "$ref": "#/$defs/InitialAccessBrokerFindingDetail",
          "description": "Initial Access Broker finding detail type."
        },
        "targetTechnology": {
          "$ref": "#/$defs/TargetTechnologyFindingDetail",
          "description": "Technology Watchlist finding detail type."
        },
        "domainMonitoring": {
          "$ref": "#/$defs/DomainMonitoringFindingDetail",
          "description": "Domain Monitoring finding detail type."
        },
        "detailType": {
          "description": "Output only. Name of the detail type. Will be set by the server during creation to the name of the field that is set in the detail union.",
          "readOnly": true,
          "type": "string"
        }
      },
      "type": "object",
      "description": "Wrapper class that contains the union struct for all the various findings detail specific classes."
    },
    "Infrastructure": {
      "properties": {
        "certificateDetails": {
          "$ref": "#/$defs/CertificateDetails",
          "description": "Optional. SSL certificate details."
        },
        "urlResponse": {
          "description": "Optional. The raw URL response string.",
          "type": "string"
        }
      },
      "description": "Core infrastructure observations associated with the URL or Domain.",
      "type": "object"
    },
    "InitialAccessBrokerFindingDetail": {
      "description": "A detail object for an Initial Access Broker (IAB) finding.",
      "type": "object",
      "properties": {
        "matchScore": {
          "format": "float",
          "description": "Required. Reference to the match score of the IAB finding. This is a float value between 0 and 1 calculated by the matching engine based on the similarity of the document and the user provided configurations.",
          "type": "number"
        },
        "documentId": {
          "type": "string",
          "description": "Optional. Deprecated: Use `discovery_document` instead. The unique identifier of the document that triggered the IAB finding. This ID can be used to retrieve the content of the document for further analysis.",
          "deprecated": true
        },
        "discoveryDocument": {
          "$ref": "#/$defs/DiscoveryDocument",
          "description": "Optional. The discovery document associated with the IAB finding."
        },
        "severity": {
          "description": "Required. The severity of the IAB finding. This indicates the potential impact of the threat.",
          "enum": [
            "SEVERITY_UNSPECIFIED",
            "LOW",
            "MEDIUM",
            "HIGH",
            "CRITICAL"
          ],
          "type": "string"
        }
      }
    },
    "InsiderThreatFindingDetail": {
      "type": "object",
      "description": "A detail object for a InsiderThreat finding.",
      "properties": {
        "discoveryDocument": {
          "$ref": "#/$defs/DiscoveryDocument",
          "description": "Optional. The discovery document associated with the Insider Threat finding."
        },
        "documentId": {
          "type": "string",
          "description": "Optional. Deprecated: Use `discovery_document` instead. The unique identifier of the document that triggered the InsiderThreat finding. This ID can be used to retrieve the content of the document for further analysis.",
          "deprecated": true
        },
        "severity": {
          "description": "Required. The severity of the InsiderThreat finding. This indicates the potential impact of the threat.",
          "enum": [
            "SEVERITY_UNSPECIFIED",
            "LOW",
            "MEDIUM",
            "HIGH",
            "CRITICAL"
          ],
          "type": "string"
        },
        "matchScore": {
          "format": "float",
          "type": "number",
          "description": "Required. Reference to the match score of the InsiderThreat finding. This is a float value greater than 0 and less than or equal to 1 calculated by the matching engine based on the similarity of the document and the user provided configurations."
        }
      }
    },
    "ProductFix": {
      "description": "Contains details about a product fix.",
      "properties": {
        "publishTime": {
          "type": "string",
          "format": "google-datetime",
          "description": "Optional. The published time of the fix."
        },
        "uri": {
          "type": "string",
          "description": "Optional. The URI of the fix."
        },
        "sourceId": {
          "type": "string",
          "description": "Required. The source ID of the fix. Ex: \"APPSEC-1420\"."
        },
        "displayName": {
          "type": "string",
          "description": "Required. The name of the fix. Ex: \"Magento\"."
        }
      },
      "type": "object"
    },
    "PublicExploit": {
      "description": "Contains details about a public exploit.",
      "properties": {
        "exploitGrade": {
          "description": "Optional. The grade of the exploit. Ex: \"non-weaponized\".",
          "enum": [
            "EXPLOIT_GRADE_UNSPECIFIED",
            "UNEVALUATED",
            "PROOF_OF_CONCEPT",
            "NON_WEAPONIZED",
            "WEAPONIZED",
            "SCANNER",
            "FAKE"
          ],
          "type": "string"
        },
        "sizeBytes": {
          "format": "int64",
          "type": "string",
          "description": "Optional. The size of the exploit."
        },
        "exploitName": {
          "description": "Required. The name of the exploit. Ex: \"Magentounauth.php.txt\".",
          "type": "string"
        },
        "uri": {
          "description": "Optional. The URI of the exploit.",
          "type": "string"
        },
        "exploitReliability": {
          "description": "Optional. The reliability of the exploit. Ex: \"Unreviewed\".",
          "enum": [
            "EXPLOIT_RELIABILITY_UNSPECIFIED",
            "UNREVIEWED",
            "REVIEWED",
            "TESTED"
          ],
          "type": "string"
        },
        "releaseTime": {
          "type": "string",
          "format": "google-datetime",
          "description": "Optional. The release time of the exploit."
        }
      },
      "type": "object"
    },
    "Relationships": {
      "description": "Related entities and domains observed for the target.",
      "properties": {
        "relatedUrls": {
          "type": "array",
          "description": "Optional. Related URLs associated with the domain.",
          "items": {
            "type": "string"
          }
        },
        "siblingDomains": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Optional. Sibling domains sharing the same IP address."
        },
        "subdomains": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Optional. Subdomains associated with the target domain or URL."
        }
      },
      "type": "object"
    },
    "RelevanceAnalysis": {
      "properties": {
        "confidence": {
          "description": "The level of confidence in the given verdict.",
          "type": "string",
          "enum": [
            "CONFIDENCE_LEVEL_UNSPECIFIED",
            "CONFIDENCE_LEVEL_LOW",
            "CONFIDENCE_LEVEL_MEDIUM",
            "CONFIDENCE_LEVEL_HIGH"
          ]
        },
        "relevanceLevel": {
          "enum": [
            "RELEVANCE_LEVEL_UNSPECIFIED",
            "RELEVANCE_LEVEL_LOW",
            "RELEVANCE_LEVEL_MEDIUM",
            "RELEVANCE_LEVEL_HIGH"
          ],
          "type": "string",
          "description": "The level of relevance."
        },
        "evidence": {
          "$ref": "#/$defs/Evidence",
          "description": "Evidence supporting the verdict, including matched and unmatched items."
        },
        "relevant": {
          "description": "Indicates whether the threat is considered relevant.",
          "type": "boolean"
        },
        "reasoning": {
          "type": "string",
          "description": "Human-readable explanation from the matcher, detailing why a particular result is considered relevant or not relevant."
        }
      },
      "type": "object",
      "description": "Structured relevance analysis for a threat."
    },
    "SeverityAnalysis": {
      "description": "Structured severity analysis for a threat.",
      "properties": {
        "severityLevel": {
          "enum": [
            "SEVERITY_LEVEL_UNSPECIFIED",
            "SEVERITY_LEVEL_LOW",
            "SEVERITY_LEVEL_MEDIUM",
            "SEVERITY_LEVEL_HIGH"
          ],
          "description": "The level of severity.",
          "type": "string"
        },
        "confidence": {
          "enum": [
            "CONFIDENCE_LEVEL_UNSPECIFIED",
            "CONFIDENCE_LEVEL_LOW",
            "CONFIDENCE_LEVEL_MEDIUM",
            "CONFIDENCE_LEVEL_HIGH"
          ],
          "description": "The level of confidence in the given verdict.",
          "type": "string"
        },
        "reasoning": {
          "description": "Human-readable explanation from the model, detailing why a particular result is considered to have a certain severity.",
          "type": "string"
        }
      },
      "type": "object"
    },
    "TargetTechnologyFindingDetail": {
      "properties": {
        "vulnerabilityMatch": {
          "$ref": "#/$defs/VulnerabilityMatch",
          "description": "Optional. The vulnerability match details."
        }
      },
      "type": "object",
      "description": "Contains details for a technology watchlist finding."
    },
    "ThreatAttributionDetails": {
      "description": "Threat attribution information (actor, campaign, etc.).",
      "properties": {
        "malware": {
          "type": "array",
          "description": "Optional. The malware associated with the threat.",
          "items": {
            "type": "string"
          }
        },
        "collections": {
          "description": "Optional. The threat collections detected.",
          "type": "array",
          "items": {
            "type": "string"
          }
        },
        "actors": {
          "type": "array",
          "description": "Optional. The threat actors associated with the target.",
          "items": {
            "type": "string"
          }
        }
      },
      "type": "object"
    },
    "VulnerabilityMatch": {
      "description": "Contains details about a vulnerability match.",
      "properties": {
        "collectionId": {
          "description": "Required. The collection ID of the vulnerability. Ex: \"vulnerability--cve-2025-9876\".",
          "type": "string"
        },
        "riskRating": {
          "enum": [
            "RISK_RATING_UNSPECIFIED",
            "LOW",
            "MEDIUM",
            "HIGH",
            "CRITICAL",
            "UNRATED"
          ],
          "type": "string",
          "description": "Required. The risk rating of the vulnerability."
        },
        "associations": {
          "items": {
            "$ref": "#/$defs/Association"
          },
          "description": "Optional. Associated threat actors, malware, etc. This is embedded as a snapshot because the details of the association at the time of the vulnerability match are important for context and reporting.",
          "type": "array"
        },
        "cvss3Score": {
          "type": "number",
          "description": "Required. The CVSS score of the vulnerability. Evaluates to CVSS v3 when available with a fallback to v2 and v4. Example: 6.4.",
          "format": "float"
        },
        "technologies": {
          "type": "array",
          "description": "Required. All technologies affected by the vulnerability, using the vendor and product names of its affected products, optionally followed by a version. Ex: `Apache Struts 2.2.3`.",
          "items": {
            "type": "string"
          }
        },
        "productFixes": {
          "description": "Optional. List of product fixes for the vulnerability.",
          "items": {
            "$ref": "#/$defs/ProductFix"
          },
          "type": "array"
        },
        "priority": {
          "description": "Optional. The priority level of the vulnerability data. Ex: \"P1\".",
          "enum": [
            "PRIORITY_UNSPECIFIED",
            "P0",
            "P1",
            "P2",
            "P3",
            "P4"
          ],
          "type": "string"
        },
        "cveId": {
          "type": "string",
          "description": "Required. The CVE ID of the vulnerability. Ex: \"CVE-2025-9876\". See https://www.cve.org/ for more information."
        },
        "exploitationVectors": {
          "type": "array",
          "items": {
            "enum": [
              "EXPLOITATION_VECTOR_UNSPECIFIED",
              "ADMINISTRATIVE_INTERFACE",
              "BLUETOOTH_ACCESS",
              "BROWSER",
              "COMPROMISED_COMMUNICATION_CHANNEL",
              "EMAIL",
              "EXPOSED_WEB_APPLICATION",
              "LOCAL_NETWORK_ACCESS",
              "MALICIOUS_APPLICATION",
              "MALICIOUS_FILE",
              "MALICIOUS_SERVER",
              "OPEN_PORT",
              "PHYSICAL_ACCESS",
              "SHORT_RANGE_RADIO",
              "UNSPECIFIED_LOCAL_VECTOR",
              "UNSPECIFIED_REMOTE_VECTOR",
              "VPN_ACCESS",
              "WIFI_ACCESS"
            ],
            "type": "string"
          },
          "description": "Optional. List of exploitation vectors for the vulnerability."
        },
        "matchedTechnologies": {
          "items": {
            "type": "string"
          },
          "description": "Optional. The entries from the configured watchlist that triggered the match, exactly as written in `TechnologyWatchListConfig.technologies`. Ex: `apache http_server 2.4.54`.",
          "type": "array"
        },
        "description": {
          "description": "Required. A description of the vulnerability.",
          "type": "string"
        },
        "epssScore": {
          "format": "float",
          "description": "Optional. The EPSS score, representing the probability of exploitation. Example: 0.87.",
          "type": "number"
        },
        "exploitationState": {
          "description": "Required. The exploitation state of the vulnerability.",
          "enum": [
            "EXPLOITATION_STATE_UNSPECIFIED",
            "EXPLOITATION_STATE_NO_KNOWN",
            "EXPLOITATION_STATE_REPORTED",
            "EXPLOITATION_STATE_SUSPECTED",
            "EXPLOITATION_STATE_CONFIRMED",
            "EXPLOITATION_STATE_WIDESPREAD"
          ],
          "type": "string"
        },
        "disclosureTime": {
          "format": "google-datetime",
          "type": "string",
          "description": "Optional. The disclosure time of the vulnerability."
        },
        "publicExploits": {
          "description": "Optional. List of public exploits.",
          "type": "array",
          "items": {
            "$ref": "#/$defs/PublicExploit"
          }
        },
        "exploitationConsequences": {
          "type": "array",
          "description": "Optional. List of exploitation consequences for the vulnerability.",
          "items": {
            "type": "string",
            "enum": [
              "EXPLOITATION_CONSEQUENCE_UNSPECIFIED",
              "CODE_EXECUTION",
              "COMMAND_EXECUTION",
              "DATA_LOSS",
              "DATA_MANIPULATION",
              "DENIAL_OF_SERVICE",
              "INFORMATION_DISCLOSURE",
              "UNAUTHORIZED_ACCESS",
              "PRIVILEGE_ESCALATION",
              "SANDBOX_ESCAPE",
              "SECURITY_BYPASS",
              "CONTAINER_ESCAPE",
              "SPOOFING"
            ]
          }
        },
        "publiclyAvailableExploit": {
          "readOnly": true,
          "type": "boolean",
          "description": "Output only. Whether a publicly available exploit exists."
        }
      },
      "type": "object"
    }
  }
}