Skip to main content
GET
/
v1
/
nostro-accounts
/
transfers
Get Nostro Account Liquidity Transfer List
curl --request GET \
  --url https://api.pgw-sandbox.finventi.com/v1/nostro-accounts/transfers
{
  "meta": {
    "amount": 123,
    "limit": 123,
    "offset": 123
  },
  "result": [
    {
      "amount": 123,
      "creditorAccount": "<string>",
      "id": 123,
      "sepaMessageId": "<string>",
      "status": "CREATED",
      "createdAt": "2023-11-07T05:31:56Z",
      "debtorAccount": "<string>",
      "settlementDate": "2023-12-25",
      "updatedAt": "2023-11-07T05:31:56Z"
    }
  ]
}

Overview

This endpoint retrieves liquidity transfer records between your Nostro accounts. Track fund movements and manage liquidity across different clearing systems.

Transfer Information

  • Transfer amount and currency
  • Source and destination accounts
  • Transfer status and timestamps
  • Reference information

Query Parameters

limit
string

A limit on the number of objects returned per page. The default is 10 items.

offset
string

Specifies the starting position for retrieving items in paginated results. The default is 0 items.

id
string

A filter by liquidity transfer request ID.

debtorAccount
string

A filter by debtor account.

creditorAccount
string

A filter by creditor account.

status
enum<string>

A filter by liquidity transfer request status. Multiple values are supported e.g. status=CREATED&status=COMPLETED

Available options:
CREATED,
SENT_TO_CLEAR,
ACCEPTED,
REJECTED,
COMPLETED
createdFrom
string

A filter by liquidity transfer request date time from (ISO-8601 format).

Example:

"2023-10-24T12:00:00Z"

createdTo
string

A filter by liquidity transfer request date time to (ISO-8601 format).

Example:

"2023-10-24T12:00:00Z"

sort
string
required

A sort by liquidity transfer request id field

Response

Returned Nostro Account Liquidity Transfer List

meta
object
required

Result metadata.

result
object[]
required

List of found transactions for provided filters.