Propose the Federal Reserve's interest credit read off its Statement of Account (the reporting service's statement feed), matched to the accrual; nothing posts until a treasury checker reviews it

POST/ledger/reserve-interest/statement-credits

Feed the interest credit read off the Federal Reserve's master account report. This is the one route the statement feed's scope reaches: the ledger's guard admits ledger:reserve-interest:statement and nothing else here, and the store admits only the reporting service's own subject (svc_reporting) on that scope — staff, an API key and every other service are refused 403 forbidden. The credit is a proposal: nothing posts until a treasury checker other than the feed reviews it. A redelivered report posts nothing again.

Headers

Idempotency-KeystringOptional

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

Body parameters

amountintegerRequired

currency_codestringRequired

period_endstring · dateRequired

A business date, YYYY-MM-DD

period_startstring · dateRequired

A business date, YYYY-MM-DD

referencestringRequired

statement_refstringOptional

The reporting service's retained Statement of Account the credit was read from

Returns

200 OK

accrual_matchedbooleanRequired

The credit equals the accrual rounded to the cent

accruedstringRequired

The period's accrual, dollars to eight places

amountintegerRequired

currency_codestringRequired

difference_amountintegerRequired

The credit less that accrual

expected_amountintegerRequired

That accrual rounded to the cent

idintegerRequired

journal_idstringOptional

Example jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm

makerstringRequired

matchedbooleanRequired

Settled when recorded (statement credits before proposals were reviewed)

period_endstring · dateRequired

A business date, YYYY-MM-DD

period_startstring · dateRequired

A business date, YYYY-MM-DD

recorded_atstring · date-timeRequired

referencestringRequired

reviewobject or nullOptional

ReserveReviewRecord is a retained review.

5 child attributes

approvebooleanRequired

checkerstringRequired

The verified treasury checker, never the maker

journal_idstringOptional

Example jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm

reasonstringRequired

recorded_atstring · date-timeRequired

sourcestringRequired

Fed_statement (the Fed account statement) or treasury (entered by hand)

statement_refstringOptional

statusstringRequired

Errors

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

400401403404409412413422424429500503