Audit & transparency

Match explainability

When requested with explain=true, a match may include the versioned v3_explainability compatibility field. It provides diagnostic evidence, not the canonical decision or a substitute for coverage and identity assessment.

What you get

calibrated_confidence

Final confidence (0–100) after temperature scaling. The temperature actually applied is returned in calibration.temperature, a tuning value, not a fixed contract.

feature_contributions

Per-field breakdown (name, DOB, country, type, identifier) with percentage contribution and comparison level.

threshold_reasoning

Diagnostic threshold reasoning from the compatibility payload. It does not replace the canonical decision, coverage state, identity assessment, or your policy.

evidence_summary

Human-readable per-field evidence descriptions.

calibration

Raw vs. calibrated confidence and the temperature factor used.

Illustrative response with explain

json

{
  "matches": [{
    "id": "ofac-sdn-15547",
    "name": "Rosneft Oil Company",
    "confidence": 98,
    "risk_level": "critical",
    "v3_explainability": {
      "human_readable": "OFAC SDN entry with 94.5% calibrated confidence. Primary name exhibits strong similarity.",
      "calibrated_confidence": 94.5,
      "feature_contributions": [
        { "field": "name", "level": "exact_full", "contribution_percent": 74.2 },
        { "field": "date_of_birth", "level": "exact", "contribution_percent": 13.2 }
      ],
      "threshold_reasoning": {
        "decision": "BLOCK",
        "explanation": "Confidence 94.5% exceeds the 90% BLOCK threshold."
      },
      "modifiers": [],
      "calibration": {
        "temperature": 0.2,
        "raw_confidence": 97.2,
        "calibrated_confidence": 94.5
      },
      "evidence_summary": {
        "name": "High similarity between query and listed name.",
        "date_of_birth": "Full DOB match.",
        "country": "Matches listed nationality.",
        "entity_type": "Entity types align.",
        "identifier": "No identifier comparison performed."
      }
    }
  }]
}