# TreasuryLedgerReconciliation

[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>treasury-ledger-custody-reconciliation-candidate-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>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>status</code> | Yes | Constant <code>REVIEW&#95;CANDIDATE</code> | — |
| <code>mappings</code> | Yes | Array of <code>object</code> | Min items: <code>1</code>; Max items: <code>256</code> |
| <code>mappings&#91;&#93;.ledger</code> | Yes | <code>object</code> | Additional properties rejected |
| <code>mappings&#91;&#93;.ledger.recordId</code> | Yes | <code>string</code> | Pattern: <code>^&#91;a-zA-Z0-9&#93;&#91;a-zA-Z0-9:&#95;-&#93;{2,159}$</code> |
| <code>mappings&#91;&#93;.ledger.resourceVersion</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>mappings&#91;&#93;.ledger.artifactHash</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>mappings&#91;&#93;.custody</code> | Yes | <code>object</code> | Additional properties rejected |
| <code>mappings&#91;&#93;.custody.evidenceId</code> | Yes | <code>string</code> | Pattern: <code>^&#91;a-zA-Z0-9&#93;&#91;a-zA-Z0-9:&#95;-&#93;{2,159}$</code> |
| <code>mappings&#91;&#93;.custody.resourceVersion</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>mappings&#91;&#93;.capitalContainerId</code> | Yes | <code>string</code> | Pattern: <code>^&#91;a-zA-Z0-9&#93;&#91;a-zA-Z0-9:&#95;-&#93;{2,159}$</code> |
| <code>mappings&#91;&#93;.declaredCustodyLocationId</code> | Yes | <code>string</code> | Pattern: <code>^&#91;a-zA-Z0-9&#93;&#91;a-zA-Z0-9:&#95;-&#93;{2,159}$</code> |
| <code>mappings&#91;&#93;.declaredSource</code> | Yes | <code>object</code> | Additional properties rejected |
| <code>mappings&#91;&#93;.declaredSource.kind</code> | Yes | <code>string</code> | Allowed: <code>SAFE</code>, <code>VAULT</code>, <code>EXTERNAL&#95;MANAGER</code> |
| <code>mappings&#91;&#93;.declaredSource.id</code> | Yes | <code>string</code> | Pattern: <code>^&#91;a-zA-Z0-9&#93;&#91;a-zA-Z0-9:&#95;-&#93;{2,159}$</code> |
| <code>mappings&#91;&#93;.unit</code> | Yes | <code>object</code> | Additional properties rejected |
| <code>mappings&#91;&#93;.unit.chainId</code> | Yes | <code>integer</code> | Maximum: <code>9007199254740991</code>; Exclusive minimum: <code>0</code> |
| <code>mappings&#91;&#93;.unit.genesisHash</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>mappings&#91;&#93;.unit.asset</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{40}$</code> |
| <code>mappings&#91;&#93;.unit.decimals</code> | Yes | <code>integer</code> | Minimum: <code>0</code>; Maximum: <code>36</code> |
| <code>mappings&#91;&#93;.custodyAccount</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{40}$</code> |
| <code>mappings&#91;&#93;.relationship</code> | Yes | <code>object</code> | Additional properties rejected |
| <code>mappings&#91;&#93;.relationship.id</code> | Yes | <code>string</code> | Pattern: <code>^&#91;a-zA-Z0-9&#93;&#91;a-zA-Z0-9:&#95;-&#93;{2,159}$</code> |
| <code>mappings&#91;&#93;.relationship.resourceVersion</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>mappings&#91;&#93;.relationship.evidenceHash</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>mappings&#91;&#93;.projectId</code> | Yes | <code>string</code> | Pattern: <code>^&#91;a-zA-Z0-9&#93;&#91;a-zA-Z0-9:&#95;-&#93;{2,159}$</code> |
| <code>mappings&#91;&#93;.block</code> | Yes | <code>object</code> | Additional properties rejected |
| <code>mappings&#91;&#93;.block.number</code> | Yes | <code>string</code> | Pattern: <code>^&#40;0&#124;&#91;1-9&#93;&#91;0-9&#93;{0,77}&#41;$</code> |
| <code>mappings&#91;&#93;.block.hash</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>mappings&#91;&#93;.block.timestamp</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>mappings&#91;&#93;.ledgerAmountAtomic</code> | Yes | <code>string</code> | Pattern: <code>^&#40;0&#124;&#91;1-9&#93;&#91;0-9&#93;{0,77}&#41;$</code> |
| <code>mappings&#91;&#93;.observedCustodyAmountAtomic</code> | Yes | <code>string</code> | Pattern: <code>^&#40;0&#124;&#91;1-9&#93;&#91;0-9&#93;{0,77}&#41;$</code> |
| <code>mappings&#91;&#93;.unallocatedCustodySurplusAtomic</code> | Yes | <code>string</code> | Pattern: <code>^&#40;0&#124;&#91;1-9&#93;&#91;0-9&#93;{0,77}&#41;$</code> |
| <code>mappings&#91;&#93;.ledgerState</code> | Yes | <code>string</code> | Allowed: <code>AVAILABLE</code>, <code>DEPLOYED</code>, <code>LOCKED</code>, <code>AT&#95;RISK</code>, <code>FEE&#95;GENERATING</code> |
| <code>mappings&#91;&#93;.committedQuoteValuation</code> | Yes | <code>string</code> | Pattern: <code>^&#40;0&#124;&#91;1-9&#93;&#91;0-9&#93;{0,77}&#41;$</code> |
| <code>mappings&#91;&#93;.obligationIds</code> | Yes | Array of <code>string</code> | Max items: <code>256</code> |
| <code>mappings&#91;&#93;.disposition</code> | Yes | Constant <code>PROPOSED&#95;MAPPING&#95;REQUIRES&#95;ADMISSION</code> | — |
| <code>sourceBindings</code> | Yes | <code>object</code> | Additional properties rejected |
| <code>sourceBindings.ledger</code> | Yes | Array of <code>object</code> | Min items: <code>1</code>; Max items: <code>256</code> |
| <code>sourceBindings.ledger&#91;&#93;.recordId</code> | Yes | <code>string</code> | Pattern: <code>^&#91;a-zA-Z0-9&#93;&#91;a-zA-Z0-9:&#95;-&#93;{2,159}$</code> |
| <code>sourceBindings.ledger&#91;&#93;.resourceVersion</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>sourceBindings.ledger&#91;&#93;.artifactHash</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>sourceBindings.custody</code> | Yes | Array of <code>object</code> | Min items: <code>1</code>; Max items: <code>256</code> |
| <code>sourceBindings.custody&#91;&#93;.evidenceId</code> | Yes | <code>string</code> | Pattern: <code>^&#91;a-zA-Z0-9&#93;&#91;a-zA-Z0-9:&#95;-&#93;{2,159}$</code> |
| <code>sourceBindings.custody&#91;&#93;.resourceVersion</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>sourceHash</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>candidateHash</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>ledgerConservation</code> | Yes | <code>object</code> | Additional properties rejected |
| <code>ledgerConservation.scope</code> | Yes | Constant <code>SUPPLIED&#95;IMMUTABLE&#95;ENTRIES&#95;ONLY</code> | — |
| <code>ledgerConservation.ledgerVersion</code> | Yes | <code>string</code> | Allowed: <code>treasury-ledger-v1</code>, <code>treasury-ledger-v2</code> |
| <code>ledgerConservation.conserved</code> | Yes | Constant <code>true</code> | — |
| <code>ledgerConservation.commitment</code> | Yes | <code>string</code> | Pattern: <code>^0x&#91;0-9a-f&#93;{64}$</code> |
| <code>omittedLedgerEntryIds</code> | Yes | Array of <code>string</code> | Max items: <code>256</code> |
| <code>omittedCustodyEvidenceIds</code> | Yes | Array of <code>string</code> | Max items: <code>256</code> |
| <code>limitations</code> | Yes | Array of Not specified | — |
| <code>spendability</code> | Yes | Constant <code>NOT&#95;ESTABLISHED</code> | — |
| <code>expenseCoverage</code> | Yes | Constant <code>UNKNOWN</code> | — |
| <code>financialAuthority</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/TreasuryLedgerReconciliation</code> in the [OpenAPI contract](/openapi/liquidity-operating-system-v2.openapi.json).