Get Nostro account balances

Get Nostro Account Balances

curl --request GET \
  --url https://api.pgw-sandbox.finventi.com/v1/nostro-accounts/balances

{
  "balances": [
    {
      "accountNumber": "LT123456789123456789",
      "balance": 123,
      "balanceOwnerBic": "<string>",
      "lastSyncAt": "2023-11-07T05:31:56Z",
      "lastUpdateAt": "2023-11-07T05:31:56Z",
      "paymentScheme": "SEPAINST"
    }
  ]
}

GET

nostro-accounts

balances

Get Nostro Account Balances

curl --request GET \
  --url https://api.pgw-sandbox.finventi.com/v1/nostro-accounts/balances

{
  "balances": [
    {
      "accountNumber": "LT123456789123456789",
      "balance": 123,
      "balanceOwnerBic": "<string>",
      "lastSyncAt": "2023-11-07T05:31:56Z",
      "lastUpdateAt": "2023-11-07T05:31:56Z",
      "paymentScheme": "SEPAINST"
    }
  ]
}

Overview

This endpoint provides real-time balance data for your Nostro accounts. Monitor account balances to manage liquidity and track financial operations.

Response

Returned Nostro Account Balances

balances

object[]

required

Show child attributes

balances.accountNumber

string

required

Nostro account number dedicated to manage the indicated payment scheme payments

Example:

"LT123456789123456789"

balances.balance

number

required

Nostro account balance for the time stamp indicated in the lastUpdatedAt field. Account balances is recalculated after every successful INBOUND/OUTBOUND transaction execution. Types of transactions which affect Nostro account balance: Payment, Payment return, Adjustment, CSM fees

balances.balanceOwnerBic

string

required

balances.lastSyncAt

string<date-time>

required

The date and time in UTC time zone, when the account balance was synchronised with the CSM system by provided account statement. Format YYYY-MM-DDTHH:MM:SSZ

balances.lastUpdateAt

string<date-time>

required

The date and time in UTC time zone, when the Nostro account balance was recalculated using to the INBOUND/OUTBOUND transaction data. Format YYYY-MM-DDTHH:MM:SS.000000Z

balances.paymentScheme

enum<string>

required

Payment scheme indicator

Available options:

SEPACT,

SEPAINST,

SWIFT

Example:

"SEPAINST"

XML messages Liquidity transfers

⌘I

Getting Started

Account Management

SEPA Instant

SEPA Direct Debit

SWIFT Payments

Payment Information

Nostro Accounts

Bank Information

Webhooks

Overview

Response

Getting Started

Account Management

SEPA Instant

SEPA Direct Debit

SWIFT Payments

Payment Information

Nostro Accounts

Bank Information

Webhooks

​Overview

Response

Overview