Retain current customer-owned off-bank positions and actual ledger/receiving-bank evidence separately from bank deposits and assets

POST/reporting/agency-position-snapshots

Fresh reporting staff captures and verifies the actual current payments source digest and retains it immutably. Actor-bound key replays original observation, even if later statements change. Missing source refuses; unknown interest and incomplete reconciliation remain explicit. Reporting performs no money posting.

Headers

Idempotency-KeystringRequired

Send on every write that creates or changes money or state; a replay with the same key returns the original result with 200.

Returns

200 OK

actorstringRequired

captured_atstring · date-timeRequired

content_sha256stringRequired

idstringRequired

snapshotobjectRequired

6 child attributes

blockersarray of stringsRequired

captured_atstring · date-timeRequired

observation_datestring · dateRequired

A business date, YYYY-MM-DD

positionsarray of objectsRequired

8 child attributes

blockersarray of stringsRequired

interest_as_ofstring · date or nullOptional

A business date, YYYY-MM-DD

observed_accrued_interest_amountinteger or nullOptional

off_bank_principal_amountinteger or nullOptional

outbound_journalobjectOptional

placementobjectRequired

25 child attributes

accounting_plan_sha256stringOptional

accounting_plansarray of objectsOptional

actorstringRequired

capacityobjectRequired

cash_hold_idstringOptional

Example hold_2tVh8nqLxq4GbDe0K1F6S9zRcWm

created_atstring · date-timeRequired

customer_hold_idstringOptional

Example hold_2tVh8nqLxq4GbDe0K1F6S9zRcWm

decisionobject or nullOptional

exceptionsarray of stringsRequired

idstringRequired

instructionobject or nullOptional

Instruction is an immutable, authorized bridge command. Reading a draft is not dispatch.

journal_idstringOptional

Example jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm

latest_statementobject or nullOptional

Statement is the receiving bank's signed principal and accrued-interest observation for an existing allocation. It is not a funds-transfer receipt.

posting_datestring · date or nullOptional

A business date, YYYY-MM-DD

prior_redemptionsarray of objectsOptional

programobjectRequired

receiptobject or nullOptional

Receipt is signed by a key in the independently approved retained program. Evidence retains the receiving-bank allocation and actual settlement confirmation, not an ACK.

redemptionobject or nullOptional

requestobjectRequired

request_sha256stringRequired

screening_atstring · date-time or nullOptional

screening_idsarray of stringsOptional

sourceobjectRequired

statusstringRequired

sweep_authorizationobject or nullOptional

Generated Placement.Actor and Redemption.Actor retain Mandate.Consent.Actor, the real authorizing customer. Run.Actor and persistence events identify the actual executing bridge; callers must never synthesize customer claims or a fresh human approval to execute this retained standing authority.

redemption_journalobjectOptional

reserved_insurance_headroomintegerRequired

readybooleanRequired

source_sha256stringRequired

Errors

Every error is a problem document with a stable code. See Errors.

400401403404409412413422424429500503