Contract Assurance Monitor Data Contracts

Obligation Score Request (POST /v1/contracts/obligations/score)

Required fields

Field	Type
tenant_id	string
contract_id	string
obligation_id	string
control_id	string
entity_id	string
event_id	string
score_version	string
evidence_events	ObligationEvidenceEvent[]

Optional fields

Field	Type
control_effectiveness	number (0-1, default 0.5)
stake	ObligationStakeContext

ObligationStakeContext

{
  "impact_level": "high",
  "weighting": 1.1
}

ObligationEvidenceEvent

{
  "evidence_id": "ev-a-1",
  "event_type": "telemetry.accepted",
  "quality": 0.9,
  "fulfillment": 0.82,
  "weight": 1.2
}

Response Shape

{
  "accepted": true,
  "tenant_id": "tenant-a",
  "actor_id": "actor-a",
  "request_id": "fixture-positive-req-a",
  "contract_id": "contract-a-001",
  "obligation_id": "obligation-a-001",
  "control_id": "control-a-7",
  "entity_id": "agent-a-9",
  "event_id": "evt-a-1001",
  "score_version": "fidelity_v0",
  "scores": {
    "fidelity_v0": 0.7496,
    "mandate_v0": 0.7368,
    "meridian_v0": 0.82,
    "composite_v0": 0.7688
  },
  "breach_risk": 0.2925,
  "recommended_action": "review",
  "trend": {
    "direction": "flat",
    "delta": 0.0,
    "previous_composite_v0": null,
    "current_composite_v0": 0.7688
  },
  "lineage": {
    "evidence_event_id": "90921404-a071-4f24-82c4-8e684f737527",
    "score_snapshot_id": "66bc9bc4-8497-4683-9449-7ee7ba20b6de"
  }
}