Contract Risk Analysis Run

Output representation of the status and results of a contract document version risk analysis run.

Properties

Property Name	Type	Description	Filter Group and Version	Available Version
`completedAt`	Date	Timestamp at which the run reached a terminal state.	Big, 68.0	68.0
`contractDocumentVersionId`	String	ID of the contract document version against which the risk analysis was performed.	Big, 68.0	68.0
`contractRiskAnalysisElements`	Contract Risk Analysis Element[]	List of completed document elements processed in this analysis run.	Big, 68.0	68.0
`contractRiskAnalysisRunId`	String	ID of the contract risk analysis run record that represents this analysis.	Big, 68.0	68.0
`documentContext`	String	Extracted summary of the contract document used as context for AI-driven risk analysis of individual clauses.	Big, 68.0	68.0
`error`	Contract Risk Analysis Error	Error code and error message when the API request is unsuccessful.	Big, 68.0	68.0
`initiatedById`	String	ID of the user who initiated the run.	Big, 68.0	68.0
`overallScore`	Double	Aggregate risk score for the run, computed as the average of all finding risk scores. Ranges from 0 through 100, where a higher value indicates greater risk. Populated only when the run is completed.	Big, 68.0	68.0
`overallSeverity`	String	Highest severity across all findings produced in this run. Valid values are `Low`, `Medium`, `High`, or `Critical`.	Big, 68.0	68.0
`processedElementCount`	Integer	Number of elements completed so far, whether analysis finished successfully or failed. Use this value to render a progress indicator. Equals `totalElementCount` when the run is completed.	Big, 68.0	68.0
`startedAt`	Date	Timestamp at which the run began change detection.	Big, 68.0	68.0
`status`	String	Current lifecycle state of the analysis run. Valid values are `New`, `Skipped`, `Running`, `Completed`, or `Failed`.	Big, 68.0	68.0
`success`	Boolean	Indicates whether the API request was successful (`true`) or not (`false`).	Big, 68.0	68.0
`summary`	String	Executive summary of all findings, for a quick review of the document’s risk posture without drilling into individual clauses. Populated only when the run is completed.	Big, 68.0	68.0
`totalElementCount`	Integer	Total number of elements for this run. Populated after change detection completes.	Big, 68.0	68.0

JSON Example

1{
2  "contractRiskAnalysisRunId": "1gMRM0000004DBq",
3  "contractDocumentVersionId": "0qtRM0000004CGv",
4  "initiatedById": "005xx000001X8B7AAK",
5  "status": "Completed",
6  "startedAt": "2026-05-04T09:48:12Z",
7  "completedAt": "2026-05-04T09:52:41Z",
8  "totalElementCount": 2,
9  "processedElementCount": 2,
10  "overallScore": 82.0,
11  "overallSeverity": "Critical",
12  "summary": "Document contains 1 critical liability cap reduction and 1 high-risk governing law change.",
13  "documentContext": "Master services agreement covering liability, indemnification, and governing law provisions.",
14  "success": true,
15  "contractRiskAnalysisElements": [
16    {
17      "contractRiskAnalysisElementId": "1WJRM0000001AAA",
18      "elementName": "Limitation of Liability",
19      "processingStage": "Persist",
20      "processingStatus": "Completed",
21      "elementType": "Clause",
22      "contractRiskAnalysisFinding": {
23        "contractRiskAnalysisFindingId": "1dwRM0000001AAA",
24        "severity": "Critical",
25        "riskScore": 95.0,
26        "matchType": "NonStandard",
27        "actualText": "Liability of either party shall not exceed one hundred thousand dollars ($100,000).",
28        "status": "Pending"
29      }
30    }
31  ]
32}