> ## Documentation Index
> Fetch the complete documentation index at: https://docs.finventi.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Liquidity management

> How settlement accounts, liquidity transfers and withdrawals to safeguarding accounts fit together.

## Settlement accounts

A settlement account is the account where your payments settle in a clearing system. Every scheme you are connected to has its own settlement account, and each clearing system uses its own name for it:

| Clearing system | Settlement accounts |
| - | - |
| **CENTROlink** (Bank of Lithuania) | Funds accounts for SCT and SCT Inst |
| **EKS** (Latvijas Banka) | Clearing cover account (SCT) and IP cover account (SCT Inst) |
| **T2** | Main cash account (MCA) and dedicated cash accounts (DCA) |
| **SWIFT** | Correspondent accounts at your correspondent banks |

<Note>
  For backward compatibility, the API exposes settlement accounts under the `/v1/nostro-accounts` paths and uses `nostro` in field names. The dashboard and this documentation call them settlement accounts.
</Note>

## What you can do

| Action | How | Guide |
| - | - | - |
| See balances of your settlement accounts | `GET /v1/nostro-accounts/balances` | [Account balances](/payments/api/nostro/nostro-account-balances/get-nostro-account-balances) |
| Move liquidity between your SCT and SCT Inst settlement accounts (CENTROlink, EKS) | `POST /v1/nostro-accounts/transfers` with `transferType: INTERNAL` (the default) | [Transfers between settlement accounts](/payments/transfers-between-settlement-accounts) |
| Withdraw excess liquidity to your safeguarding account | `POST /v1/nostro-accounts/transfers` with `transferType: SAFEGUARDING` | [Withdraw to safeguarding](/payments/withdraw-to-safeguarding) |
| Rebalance automatically between SCT and SCT Inst (CENTROlink) | Dashboard settings | [Automatic liquidity](/payments/automatic-liquidity) |
| Download settlement account statements | `GET /v1/nostro-accounts/{iban}/statements/...` | [Account statements](/payments/api/nostro/nostro-account-statements/get-nostro-account-statement-page) |

## Operational and safeguarding accounts

Withdrawals and EKS transfers use two kinds of bank accounts that you register once, in the dashboard under **Settings > Liquidity** or through the [bank accounts API](/payments/api/nostro/liquidity-bank-accounts/list-liquidity-bank-accounts):

* **Operational account** - an IBAN under one of your own BICs that is used as the debtor of the outgoing payment. It identifies you as the sender; the funds are always taken from the settlement account of the scheme the payment is sent on.
* **Safeguarding account** - the account a withdrawal is paid to, for example your safeguarding account at a credit institution. Withdrawals can only be paid to registered safeguarding accounts.

<Warning>
  **EKS participants:** before you can transfer between your EKS settlement accounts, the operational account must also be registered with Latvijas Banka in your EKS registration forms (fields 1.3.1 and 1.5.1), and EKS transfers must be enabled for your BIC. See [Transfers between settlement accounts](/payments/transfers-between-settlement-accounts#step-2-register-the-same-iban-with-latvijas-banka-eks).
</Warning>

## Transfer lifecycle

Every transfer has one of these statuses, in this order:

| Status | Meaning |
| - | - |
| `CREATED` | The transfer exists. If the underlying payment needs signing, the transfer stays `CREATED` until it is signed |
| `SENT_TO_CLEAR` | The instruction or payment was sent to the clearing system |
| `ACCEPTED` | The clearing system accepted it |
| `COMPLETED` | Settlement is confirmed |
| `REJECTED` | The clearing system rejected it, or the underlying payment was cancelled. No funds moved |

The transfer amount is never signed: a transfer moves money from one of your accounts to another. Each account's movement appears separately, as an adjustment or payment transaction linked to the transfer (`adjustmentTransactionIds`, `paymentTransactionId`).

## Permissions

| Operation | Dashboard role | API client |
| - | - | - |
| Initiate transfers, add, edit or remove liquidity bank accounts | `transaction-manager` | Read-write client |
| View transfers | `transaction-manager` | Read-write or read-only client |
| View liquidity bank accounts | `transaction-manager` or `liquidity-viewer` | Read-write or read-only client |

<Tip>
  If 4-eyes signing is enabled for your organisation, payments created by withdrawals and EKS transfers go through the same signing flow as any other payment.
</Tip>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.