Ledger
Business dates, end of day, the trial balance, the chart of accounts and GL exports.
POSTAtomically replace a deposit's availability holds
/ledger/availability-batchesGETList proposed draws waiting for a second treasury approver, pending ones first/ledger/borrowing-proposals · A read needs `ledger:read` or `ledger:post`GETThe current business date, next banking day and cutoff/ledger/business-dateGETThe chart of accounts/ledger/chart-of-accountsPOSTAtomically pay or collect complete funded checks and prevent duplicate consumption or reversal/ledger/check-source-consumptionsPOSTReserve complete check return funding before operator publication against reversal or reuse/ledger/check-source-reservationsGETList the ISO 4217 currencies the ledger knows with their minor units, whether new accounts may open in each, and each currency's FX position pair/ledger/currencies · Ledger reader authority requiredPOSTAtomically post a deposit receipt and its captured availability holds/ledger/deposit-postingsPOSTRun end of day for a business date/ledger/end-of-day-runsGETEvery GL entry of a period/ledger/gl-journal-entriesGETYear-to-date recognized deposit-interest expense by account and effective date through period YYYY-MM; excludes settlement of the accrued liability/ledger/interest-expensePOSTFence a supported unposted fee, dispute, lending or card settlement instruction, or return its committed journal/ledger/journal-cancellationsGETRead actual journal and current reversal or reliance evidence/ledger/journal-evidencePOSTClaim independently reviewed card or complaint remedy journals against generic reversal/ledger/journal-evidence-claimsPOSTPin original card clearing against reversal without consuming reconciliation ownership/ledger/journal-source-pins · An actual svc_cards service JWT with ledger:post pins the exact original card clearing for the independently reviewed card_scheme_clearing purposePOSTAllocate actual unreversed payable credits to the verified source service and reserve them against generic spending/ledger/payable-obligations · Verified owning svc_accounts or svc_lending with existing ledger:post is required even locally; staff, customers, API keys and other services cannot register sourcesGETRead bounded current payable work queue under exact payments service authority/ledger/payable-obligations · Verified svc_payments with existing ledger:post is required even locallyPOSTReserve actual payable allocations and master funds for the verified payments service's reviewed instruction/ledger/payable-remittances · Verified svc_payments with existing ledger:post is required even locallyGETTrial balance by GL code and currency/ledger/trial-balanceGETRead a proposed draw and its review/ledger/borrowing-proposals/{id} · A read needs `ledger:read` or `ledger:post`GETRead the original completed closing balances and provenance/ledger/closing-snapshots/{date}GETEvery approved lender's lendable value, advances outstanding and borrowing capacity/ledger/collateral/capacity · Every approved lender's position; reporting reads the Reserve Bank's lendable value from it for the Fed positionGETWhether the register lets the bank close a business_date: breaks and lender statements awaiting review or reconciliation beyond the reviewed tolerance, matured or ineligible pledges, and advances beyond capacity/ledger/collateral/close-readiness · Blocks on a break or a lender's latest statement awaiting review or reconciliation beyond `break_block_age_days`, a reserved or acknowledged pledge on a matured or ineligible asset, and advances beyond a lender's lendable value; ledger end of day enforces the same judgementPOSTReport a loan's current facts (the lending service): a pledged loan that went past due, to nonaccrual, charged off or paid off stops lending at once/ledger/collateral/loan-facts · Only the lending service's own identity `svc_lending` holding `ledger:post` (never staff or an API key) reports a loan's facts; any other caller is refused 403 `forbidden`POSTRecord the register's effective-dated parameters: the draw approval threshold and the break age that blocks the close, pending independent review (treasury staff)/ledger/collateral/parameters · The ledger's guard admits `ledger:treasury:write` on this route and refuses `ledger:post`; the store admits only verified treasury staff (never a service or an API key) who stepped up within five minutesGETList the register's parameter instructions and their reviews/ledger/collateral/parameters · A read needs `ledger:read` or `ledger:post`GETEvery pledge live at the close of a business date that has ended (as_of), replayed from the retained pledge events, with pledges whose undated history cannot be placed/ledger/collateral/pledge-positions · Replays every retained pledge event to the close of `as_of`, a business date that has ended (409 `conflict` otherwise): each pledge reserved, pledged or releasing at that close, with the business date its state beganGETAcknowledged pledges by lender, asset kind and class, for the Call Report's pledged securities and pledged loans/ledger/collateral/pledged-totals · A read needs `ledger:read` or `ledger:post`POSTRecord a lender's effective-dated collateral schedule: eligible classes, haircuts, valuation bases and ineligibility conditions, pending independent review (treasury staff)/ledger/collateral/schedules · The ledger's guard admits `ledger:treasury:write` on this route and refuses `ledger:post`; the store admits only verified treasury staff (never a service or an API key) who stepped up within five minutesGETList collateral schedules, optionally for one lender_id/ledger/collateral/schedules · A read needs `ledger:read` or `ledger:post`POSTRecord a lender's signed collateral statement and open a break for every difference from the register (treasury staff)/ledger/collateral/statements · The ledger's guard admits `ledger:treasury:write` on this route and refuses `ledger:post`; the store admits only verified treasury staff (never a service or an API key) who stepped up within five minutesPOSTPropose suspending, reactivating, closing or terminating a correspondent or nostro account/ledger/correspondent/control-changes · Correspondent banking authority: staff reads need ledger:correspondent:read (or ledger:read), writes need ledger:correspondent:write with a verified non-API-key staff identity and a step-up within five minutes, and a review also needs ledger:correspondent:approve and a different person from the makerGETList delivery receipts (accepted, replayed or refused with the reason)/ledger/correspondent/message-receipts · Correspondent banking authority: staff reads need ledger:correspondent:read (or ledger:read), writes need ledger:correspondent:write with a verified non-API-key staff identity and a step-up within five minutes, and a review also needs ledger:correspondent:approve and a different person from the makerPOSTDeliver a correspondent's camt.052 intraday report, camt.053 statement or camt.054 notification received over SWIFT (or by staff), reconciled on arrival/ledger/correspondent/messages · The SWIFT gateway service (svc_payments) reaches this route with one scope and nothing else of the ledger's: ledger:correspondent:route reads settlement routes, ledger:correspondent:post posts movements, ledger:correspondent:statement delivers cash management messagesPOSTPost a payment the SWIFT gateway settles through a nostro account: the journal and the references the statement will carry, in one idempotent transaction/ledger/correspondent/movements · The SWIFT gateway service (svc_payments) reaches this route with one scope and nothing else of the ledger's: ledger:correspondent:route reads settlement routes, ledger:correspondent:post posts movements, ledger:correspondent:statement delivers cash management messagesGETEvery nostro account's position at a date: due-from or overdrawn ledger balance, latest statement closing, open breaks and alerts/ledger/correspondent/positions · Correspondent banking authority: staff reads need ledger:correspondent:read (or ledger:read), writes need ledger:correspondent:write with a verified non-API-key staff identity and a step-up within five minutes, and a review also needs ledger:correspondent:approve and a different person from the makerPOSTPull the next messages from the configured message source (the correspondent bank simulator on the local stack)/ledger/correspondent/pulls · Reads the configured correspondent message source (the correspondent bank simulator on the local stack) and receives each message in order, advancing the source cursorGETThe system ledger account for a GL code and currency/ledger/gl-accounts/{gl_code}GETGL summary for a period (JSON or CSV)/ledger/gl-exports/{period}GETRead immutable payable source evidence as its actual owning service or payments service/ledger/payable-obligations/{id} · Verified owning source service or svc_payments with ledger:post reads only its authorized immutable obligationGETRecover exact native instruction and original reservation/ledger/payable-remittances/{id} · Verified svc_payments with existing ledger:post is required even locallyPOSTApprove (booking the advance after a fresh capacity check) or reject a proposed draw (a treasury checker other than its maker)/ledger/borrowing-proposals/{id}/review · The ledger's guard admits `ledger:treasury:write`; the store also requires `operations:approve`, a step-up within five minutes and a checker other than the record's maker, refused 422 `ledger.maker_checker_required`GETRead an imported lender statement or schedule and the interest it recognised/ledger/collateral/lender-imports/{id} · A read needs `ledger:read` or `ledger:post`GETRead a delivery or release with its transfer and the lender's decision/ledger/collateral/lender-submissions/{id} · A read needs `ledger:read` or `ledger:post`GETRead a retained lender statement, its breaks and its review/ledger/collateral/statements/{id} · A read needs `ledger:read` or `ledger:post`GETRead a break proposal and its review/ledger/correspondent/break-proposals/{id} · Correspondent banking authority: staff reads need ledger:correspondent:read (or ledger:read), writes need ledger:correspondent:write with a verified non-API-key staff identity and a step-up within five minutes, and a review also needs ledger:correspondent:approve and a different person from the makerGETRead a control change/ledger/correspondent/control-changes/{id} · Correspondent banking authority: staff reads need ledger:correspondent:read (or ledger:read), writes need ledger:correspondent:write with a verified non-API-key staff identity and a step-up within five minutes, and a review also needs ledger:correspondent:approve and a different person from the makerGETRead an interest period with its settlement/ledger/correspondent/interest-periods/{id} · Correspondent banking authority: staff reads need ledger:correspondent:read (or ledger:read), writes need ledger:correspondent:write with a verified non-API-key staff identity and a step-up within five minutes, and a review also needs ledger:correspondent:approve and a different person from the makerGETRead a movement and the charge expected on it/ledger/correspondent/movements/{id} · Correspondent banking authority: staff reads need ledger:correspondent:read (or ledger:read), writes need ledger:correspondent:write with a verified non-API-key staff identity and a step-up within five minutes, and a review also needs ledger:correspondent:approve and a different person from the makerGETRead a reconciliation run's evidence and balance proof/ledger/correspondent/reconciliations/{id} · Correspondent banking authority: staff reads need ledger:correspondent:read (or ledger:read), writes need ledger:correspondent:write with a verified non-API-key staff identity and a step-up within five minutes, and a review also needs ledger:correspondent:approve and a different person from the makerGETThe settlement route the SWIFT gateway sends a currency through, chosen for the destination bank when destination_bic names one: the nostro account, the correspondent's same-day window and value date, outbound charges and liquidity/ledger/correspondent/routes/{currency} · The SWIFT gateway service (svc_payments) reaches this route with one scope and nothing else of the ledger's: ledger:correspondent:route reads settlement routes, ledger:correspondent:post posts movements, ledger:correspondent:statement delivers cash management messagesGETRead a retained page with its entries/ledger/correspondent/statements/{id} · Correspondent banking authority: staff reads need ledger:correspondent:read (or ledger:read), writes need ledger:correspondent:write with a verified non-API-key staff identity and a step-up within five minutes, and a review also needs ledger:correspondent:approve and a different person from the makerPOSTReturn only unallocated loan-forwarding funds to the actual original borrower debit DDA/ledger/payable-obligations/{id}/refunds · Only verified svc_lending with existing ledger:post may refund an exact loan_forwarding obligationGETRead actual obligation allocations and opaque cash-reconciliation status/ledger/payable-obligations/{id}/status · Verified owning source service or svc_payments reads exact reserved, gross paid, returned, refunded, unallocated and net unpaid amounts plus opaque remittance identities and current independent cash readinessPOSTRetain authentic external cash before exact native settlement or return accounting/ledger/payable-remittances/{id}/receipts · Verified svc_payments with existing ledger:post is required even locallyPOSTResolve a break with a reason (a treasury checker); a pledged-asset break resolves only once its pledge is releasing or released/ledger/collateral/breaks/{id}/resolution · The ledger's guard admits `ledger:treasury:write`; the store requires `operations:approve` and a step-up within five minutesPOSTApprove or reject a parameter instruction (a treasury checker other than its maker)/ledger/collateral/parameters/{id}/review · The ledger's guard admits `ledger:treasury:write`; the store also requires `operations:approve`, a step-up within five minutes and a checker other than the record's maker, refused 422 `ledger.maker_checker_required`POSTApprove or reject a collateral schedule (a treasury checker other than its maker)/ledger/collateral/schedules/{id}/review · The ledger's guard admits `ledger:treasury:write`; the store also requires `operations:approve`, a step-up within five minutes and a checker other than the record's maker, refused 422 `ledger.maker_checker_required`POSTApprove a statement's reconciliation once every break it opened is resolved, or reject it (a treasury checker other than its recorder)/ledger/collateral/statements/{id}/review · The ledger's guard admits `ledger:treasury:write`; the store also requires `operations:approve`, a step-up within five minutes and a checker other than the record's maker, refused 422 `ledger.maker_checker_required`POSTApprove (executing the resolution) or reject a break proposal/ledger/correspondent/break-proposals/{id}/reviews · Approval executes the resolution in the same transaction: a manual match, an adjustment journal against the reviewed GL and its match, an accepted timing difference, or the dismissal of a chain or evidence breakPOSTApprove (applied only at the revision it was proposed against) or reject a control change/ledger/correspondent/control-changes/{id}/reviews · Correspondent banking authority: staff reads need ledger:correspondent:read (or ledger:read), writes need ledger:correspondent:write with a verified non-API-key staff identity and a step-up within five minutes, and a review also needs ledger:correspondent:approve and a different person from the makerPOSTApprove or reject a terms version/ledger/correspondent/terms/{id}/reviews · Correspondent banking authority: staff reads need ledger:correspondent:read (or ledger:read), writes need ledger:correspondent:write with a verified non-API-key staff identity and a step-up within five minutes, and a review also needs ledger:correspondent:approve and a different person from the makerGETRead retained actual cash receipt and independent master statement readiness/ledger/payable-remittances/{id}/receipts/{event} · Verified svc_payments with existing ledger:post is required even locally