Approve a holdings reconciliation once every break is resolved, or reject it (a securities checker other than its recorder)

POST/ledger/fedwire-securities/holdings-reconciliations/{id}/review

The guard admits staff holding ledger:securities:write and ledger:securities:approve; the store requires a step-up within five minutes and a checker other than the maker, refused 422 ledger.maker_checker_required (the database refuses it too). The same decision by the same checker replays; a different one is 409 conflict. The checker must not be the recorder, and approval is refused 409 conflict while any break is unresolved.

Path parameters

idstringRequired

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

approvebooleanRequired

reasonstringRequired

Returns

200 OK

as_ofstring · dateRequired

A business date, YYYY-MM-DD

breaksarray of objectsRequired

10 child attributes

accountstringRequired

cusipstringRequired

expected_par_amountintegerRequired

idintegerRequired

opened_atstring · date-timeRequired

operator_par_amountintegerRequired

reconciliation_idintegerRequired

resolutionstringOptional

resolved_atstring · date-time or nullOptional

resolved_bystringOptional

content_sha256stringRequired

idintegerRequired

linesarray of objectsRequired

4 child attributes

accountstringRequired

ABA/NAME

cusipstringRequired

expected_par_amountintegerRequired

operator_par_amountintegerRequired

recorded_atstring · date-timeRequired

recorded_bystringRequired

reviewobject or nullOptional

ReviewRecord is a retained review.

5 child attributes

approvebooleanRequired

checkerstringRequired

journal_idstringOptional

Example jrnl_2tVh8nqLxq4GbDe0K1F6S9zRcWm

reasonstringRequired

recorded_atstring · date-timeRequired

statementsarray of objectsRequired

8 child attributes

accountobjectRequired

Account is one securities account on a Reserve Bank's books: the participant's primary routing number and the account's name. A restricted account names the secured party whose interest the Reserve Bank marks (4.5.2).

4 child attributes

abastringRequired

namestringRequired

restrictedbooleanRequired

secured_partystringOptional

Discount_window, fhlb, public_funds, ...

activityarray of objectsRequired

7 child attributes

counterpartystringRequired

cusipstringRequired

directionstringRequired

Credit (securities in) or debit (securities out)

operator_referencestringRequired

par_amountintegerRequired

payment_amountintegerRequired

type_codestringRequired

as_ofstring · dateRequired

A business date, YYYY-MM-DD

issued_atstring · date-timeRequired

key_idstringRequired

positionsarray of objectsRequired

2 child attributes

cusipstringRequired

par_amountintegerRequired

signaturestringRequired

versionstringRequired

statusstringRequired

Pending_review, approved or rejected

Errors

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

400401403404409412413422424429500503