Contract Risk Analysis Element

Output representation of an individual document element extracted and processed during risk analysis, including its content and the risk finding.

Properties 

Property NameTypeDescriptionFilter Group and VersionAvailable Version
changeTypeStringHow this element changed relative to the prior version. Valid values are Added, Modified, Deleted, or Extracted.Big, 68.068.0
completedAtDateTimestamp at which this element reached a terminal processing state, either completed or failed.Big, 68.068.0
content​ControlIdStringMicrosoft Word content control identifier used for change tracking and cross-run deduplication.Big, 68.068.0
contentHashStringHash of the element content used for change detection and cross-run deduplication.Big, 68.068.0
contractRisk​Analysis​ElementIdStringUnique ID of the contract risk analysis element record.Big, 68.068.0
contract​RiskAnalysis​FindingContract Risk Analysis FindingRisk finding produced for this element.Big, 68.068.0
currentTextStringElement text in the current document version. Populated when changeType is Added or Modified, and suppressed for deleted elements.Big, 68.068.0
elementContextStringSurrounding context for this element.Big, 68.068.0
elementIdentifierStringHuman-readable location of this element in the document.Big, 68.068.0
elementNameStringDisplay name of this document element.Big, 68.068.0
elementTypeStringType of document component analyzed. Valid values are Clause, Section, or Other.Small, 68.068.0
errorDetailsStringDetails of the error encountered during processing, if any.Big, 68.068.0
isFinding​ReusedBooleanIndicates whether the element reuses findings from a previous analysis because the contract content has not changed (true) or not (false).Small, 68.068.0
llmResponseRawStringRaw model output before parsing into structured finding fields.Big, 68.068.0
playbookContextStringRetrieved playbook standards used for comparison against the element.Big, 68.068.0
playbookVersionIdStringID of the playbook version used when analyzing this element.Big, 68.068.0
previousTextStringThe element text from the prior document version. Populated when changeType is Modified or Deleted, and suppressed for added elements.Big, 68.068.0
processingStageStringProcessing stage of this element. Valid values are Started, QueryGen, Retrieval, RiskAnalysis, or Persist.Big, 68.068.0
processingStatusStringProcessing status of the element at its current stage. Valid values are Queued, Running, Completed, or Failed.Big, 68.068.0
retrievalQueryStringGenerated query used to fetch matching playbook standards for this element.Big, 68.068.0
startedAtDateTimestamp at which processing began for this element.Big, 68.068.0

JSON Example 

1{
2  "contractRiskAnalysisElementId": "1WJRM0000001AAA",
3  "elementName": "Limitation of Liability",
4  "processingStage": "RiskAnalysis",
5  "processingStatus": "Completed",
6  "elementType": "Clause",
7  "changeType": "Modified",
8  "elementContext": "Appears in the General Terms and Conditions, between the Indemnification and Governing Law clauses.",
9  "contractRiskAnalysisFinding": {
10    "contractRiskAnalysisFindingId": "1dwRM0000001AAA",
11    "severity": "Critical",
12    "riskScore": 95.0,
13    "status": "Pending"
14  }
15}