Corgi BankDocumentation
OpenAPI

Judge the account's balance readings against its liquidity limits, raising and resolving alerts

POST/ledger/correspondent/nostro-accounts/{id}/liquidity-evaluations

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 maker. Nostro and correspondent ledger accounts are opened, posted and closed only through this module.

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.

Returns

200 OK

breachesarray of objectsRequired
4 child attributes
kindstringRequired
observationobjectRequired

LiquidityObservation is one reading of a nostro balance: the ledger's posted balance, the correspondent's intraday available or booked balance (camt.052) or its closing balance (camt.053).

3 child attributes
balanceintegerRequired
observed_atstring · date-timeRequired
sourcestringRequired

Ledger, intraday_report or statement

suggested_amountintegerRequired

SuggestedMinor is the funding that brings the balance back to the target (below minimum, overdrawn) or the excess above the target to bring home (above maximum).

thresholdintegerRequired
nostro_account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

openarray of objectsRequired
15 child attributes
acknowledged_atstring · date-time or nullOptional
acknowledged_bystringOptional
acknowledgement_notestringOptional
currency_codestringRequired
idstringRequired
kindstringRequired
nostro_account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

observed_atstring · date-timeRequired
observed_balanceintegerRequired
raised_atstring · date-timeRequired
resolved_atstring · date-time or nullOptional
sourcestringRequired
statusstringRequired
suggested_amountintegerRequired
thresholdintegerRequired
raisedarray of objectsRequired
15 child attributes
acknowledged_atstring · date-time or nullOptional
acknowledged_bystringOptional
acknowledgement_notestringOptional
currency_codestringRequired
idstringRequired
kindstringRequired
nostro_account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

observed_atstring · date-timeRequired
observed_balanceintegerRequired
raised_atstring · date-timeRequired
resolved_atstring · date-time or nullOptional
sourcestringRequired
statusstringRequired
suggested_amountintegerRequired
thresholdintegerRequired
readingsarray of objectsRequired
3 child attributes
balanceintegerRequired
observed_atstring · date-timeRequired
sourcestringRequired

Ledger, intraday_report or statement

resolvedarray of objectsRequired
15 child attributes
acknowledged_atstring · date-time or nullOptional
acknowledged_bystringOptional
acknowledgement_notestringOptional
currency_codestringRequired
idstringRequired
kindstringRequired
nostro_account_idstringRequired

Example acct_2tVh8nqLxq4GbDe0K1F6S9zRcWm

observed_atstring · date-timeRequired
observed_balanceintegerRequired
raised_atstring · date-timeRequired
resolved_atstring · date-time or nullOptional
sourcestringRequired
statusstringRequired
suggested_amountintegerRequired
thresholdintegerRequired

Errors

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

400401403404409412413422424429500503

to move to open esc to close