# CandidateReviewReport

[All API schemas](/api-reference/schemas/)

<code>object</code> — Additional properties rejected

| Field | Required at this level | Type | Description and constraints |
| --- | --- | --- | --- |
| <code>schemaVersion</code> | Yes | Constant <code>agent-candidate-review-report-v1</code> | — |
| <code>organizationId</code> | Yes | <code>string</code> | Pattern: <code>^&#91;a-zA-Z0-9&#93;&#91;a-zA-Z0-9:&#95;-&#93;{2,159}$</code> |
| <code>runId</code> | Yes | <code>string</code> | Pattern: <code>^&#91;a-zA-Z0-9&#93;&#91;a-zA-Z0-9:&#95;-&#93;{2,159}$</code> |
| <code>reviewScope</code> | Yes | Constant <code>RESEARCH&#95;CANDIDATE&#95;EVIDENCE</code> | — |
| <code>status</code> | Yes | Constant <code>PARTIAL</code> | — |
| <code>captureHash</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>sourceCutoff</code> | Yes | <code>string</code> | Format: <code>date-time</code>; Pattern: <code>^&#40;?:&#40;?:&#92;d&#92;d&#91;2468&#93;&#91;048&#93;&#124;&#92;d&#92;d&#91;13579&#93;&#91;26&#93;&#124;&#92;d&#92;d0&#91;48&#93;&#124;&#91;02468&#93;&#91;048&#93;00&#124;&#91;13579&#93;&#91;26&#93;00&#41;-02-29&#124;&#92;d{4}-&#40;?:&#40;?:0&#91;13578&#93;&#124;1&#91;02&#93;&#41;-&#40;?:0&#91;1-9&#93;&#124;&#91;12&#93;&#92;d&#124;3&#91;01&#93;&#41;&#124;&#40;?:0&#91;469&#93;&#124;11&#41;-&#40;?:0&#91;1-9&#93;&#124;&#91;12&#93;&#92;d&#124;30&#41;&#124;&#40;?:02&#41;-&#40;?:0&#91;1-9&#93;&#124;1&#92;d&#124;2&#91;0-8&#93;&#41;&#41;&#41;T&#40;?:&#40;?:&#91;01&#93;&#92;d&#124;2&#91;0-3&#93;&#41;:&#91;0-5&#93;&#92;d&#40;?::&#91;0-5&#93;&#92;d&#40;?:&#92;.&#92;d+&#41;?&#41;?&#40;?:Z&#124;&#40;&#91;+-&#93;&#40;?:&#91;01&#93;&#92;d&#124;2&#91;0-3&#93;&#41;:&#91;0-5&#93;&#92;d&#41;&#41;&#41;$</code> |
| <code>reviewedAt</code> | Yes | <code>string</code> | Format: <code>date-time</code>; Pattern: <code>^&#40;?:&#40;?:&#92;d&#92;d&#91;2468&#93;&#91;048&#93;&#124;&#92;d&#92;d&#91;13579&#93;&#91;26&#93;&#124;&#92;d&#92;d0&#91;48&#93;&#124;&#91;02468&#93;&#91;048&#93;00&#124;&#91;13579&#93;&#91;26&#93;00&#41;-02-29&#124;&#92;d{4}-&#40;?:&#40;?:0&#91;13578&#93;&#124;1&#91;02&#93;&#41;-&#40;?:0&#91;1-9&#93;&#124;&#91;12&#93;&#92;d&#124;3&#91;01&#93;&#41;&#124;&#40;?:0&#91;469&#93;&#124;11&#41;-&#40;?:0&#91;1-9&#93;&#124;&#91;12&#93;&#92;d&#124;30&#41;&#124;&#40;?:02&#41;-&#40;?:0&#91;1-9&#93;&#124;1&#92;d&#124;2&#91;0-8&#93;&#41;&#41;&#41;T&#40;?:&#40;?:&#91;01&#93;&#92;d&#124;2&#91;0-3&#93;&#41;:&#91;0-5&#93;&#92;d&#40;?::&#91;0-5&#93;&#92;d&#40;?:&#92;.&#92;d+&#41;?&#41;?&#40;?:Z&#124;&#40;&#91;+-&#93;&#40;?:&#91;01&#93;&#92;d&#124;2&#91;0-3&#93;&#41;:&#91;0-5&#93;&#92;d&#41;&#41;&#41;$</code> |
| <code>reviewedCandidate</code> | Yes | <code>object</code> | Additional properties rejected |
| <code>reviewedCandidate.packId</code> | Yes | <code>string</code> | Pattern: <code>^decisionpack&#95;&#91;a-f0-9&#93;{32}$</code> |
| <code>reviewedCandidate.resourceVersion</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>reviewedCandidate.contentHash</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>checks</code> | Yes | Array of <code>object</code> | Max items: <code>16</code> |
| <code>checks&#91;&#93;.id</code> | Yes | <code>string</code> | Max length: <code>100</code> |
| <code>checks&#91;&#93;.status</code> | Yes | <code>string</code> | Allowed: <code>RECORDED&#95;PASS</code>, <code>RECORDED&#95;FAIL</code>, <code>UNAVAILABLE</code> |
| <code>checks&#91;&#93;.detail</code> | Yes | <code>string</code> | Max length: <code>1200</code> |
| <code>findings</code> | Yes | Array of <code>object</code> | Max items: <code>24</code> |
| <code>findings&#91;&#93;.id</code> | Yes | <code>string</code> | Pattern: <code>^finding-&#91;a-z0-9-&#93;+$</code> |
| <code>findings&#91;&#93;.summary</code> | Yes | <code>string</code> | Max length: <code>1200</code> |
| <code>findings&#91;&#93;.evidenceIds</code> | Yes | Array of <code>string</code> | Max items: <code>8</code> |
| <code>trialReferences</code> | Yes | Array of <code>object</code> | Min items: <code>1</code>; Max items: <code>4</code> |
| <code>trialReferences&#91;&#93;.kind</code> | Yes | Constant <code>RESEARCH&#95;TRIAL</code> | — |
| <code>trialReferences&#91;&#93;.runId</code> | Yes | <code>string</code> | Pattern: <code>^&#91;a-zA-Z0-9&#93;&#91;a-zA-Z0-9:&#95;-&#93;{2,159}$</code> |
| <code>trialReferences&#91;&#93;.protocolHash</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>trialReferences&#91;&#93;.trialKey</code> | Yes | <code>string</code> | Allowed: <code>baseline</code>, <code>alternative-1</code>, <code>alternative-2</code>, <code>alternative-3</code> |
| <code>trialReferences&#91;&#93;.inputHash</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>trialReferences&#91;&#93;.artifactHash</code> | Yes | At least one of: <code>string</code>; <code>null</code> | — |
| <code>trialReferences&#91;&#93;.state</code> | Yes | <code>string</code> | Allowed: <code>QUEUED</code>, <code>RUNNING</code>, <code>COMPLETED</code>, <code>FAILED</code>, <code>CANCELLED</code> |
| <code>trialReferences&#91;&#93;.recordedAt</code> | Yes | At least one of: <code>string</code>; <code>null</code> | — |
| <code>trialReferences&#91;&#93;.failureCode</code> | Yes | At least one of: <code>string</code>; <code>null</code> | — |
| <code>costs</code> | Yes | Array of <code>object</code> | Min items: <code>6</code>; Max items: <code>6</code> |
| <code>costs&#91;&#93;.category</code> | Yes | <code>string</code> | Allowed: <code>GAS</code>, <code>INCENTIVE</code>, <code>PLATFORM&#95;FEE</code>, <code>CAPITAL&#95;LOSS</code>, <code>VENUE&#95;FEE</code>, <code>SLIPPAGE</code> |
| <code>costs&#91;&#93;.status</code> | Yes | Constant <code>UNAVAILABLE</code> | — |
| <code>costs&#91;&#93;.amountAtomic</code> | Yes | <code>null</code> | — |
| <code>costs&#91;&#93;.reason</code> | Yes | <code>string</code> | Max length: <code>1200</code> |
| <code>gaps</code> | Yes | Array of <code>string</code> | Max items: <code>24</code> |
| <code>nextChecks</code> | Yes | Array of <code>string</code> | Max items: <code>5</code> |
| <code>approvalAuthorityGranted</code> | Yes | Constant <code>false</code> | — |
| <code>executionAuthorityGranted</code> | Yes | Constant <code>false</code> | — |
| <code>publicationAuthorityGranted</code> | Yes | Constant <code>false</code> | — |

Nested required fields apply when their parent object or matching union branch is present. Named types link to their complete schema.

Exact definition: <code>#/components/schemas/CandidateReviewReport</code> in the [OpenAPI contract](/openapi/liquidity-operating-system-v2.openapi.json).