List account transactions

Retrieves all the account transactions for the given connection. Account Transactions in Vumi Finlink are understood as those financial movements that are have an impact in the cash balance of one account. Account Transactions are related to a specific account through its ID

List account transactions for the given connection

Retrieve every account transaction for the given connection

GEThttps://api.finlink.vumi.io/api/v1/queries/connections/{token}/accounts/transactions

Authorization

bearerAuth

Path parameters

token*string

Token to identify the connection

Query parameters

Response

200401404500

Successfully retrieved all account transactions

Body

application/json

itemsarray of object

List of items for the current page

limitinteger (int32)

Maximum number of items per page

pageinteger (int64)

Current page number starting from zero (0)

totalItemsinteger (int64)

Total number of items across all pages

Request

JavaScriptCurlPythonHTTP

const response = await fetch('https://api.finlink.vumi.io/api/v1/queries/connections/{token}/accounts/transactions', {
    method: 'GET',
    headers: {
      "Authorization": "Bearer JWT"
    },
});
const data = await response.json();

Response

200404

{
  "items": [
    {
      "movementId": "123e4567-e89b-12d3-a456-426614174000",
      "accountId": "123e4567-e89b-12d3-a456-426614174000",
      "type": "DEPOSIT",
      "amount": 1,
      "exchangeRate": 1,
      "commission": 1,
      "taxes": 1,
      "currency": "text",
      "localCurrency": "text",
      "description": "text",
      "operationDateDay": "2025-02-05",
      "originalOperationDateDay": "2025-02-05",
      "valueDateDay": "2025-02-05",
      "originalValueDateDay": "2025-02-05",
      "operationDateHour": "text",
      "originalOperationDateHour": "text",
      "valueDateHour": "text",
      "originalValueDateHour": "text",
      "originalOperationDateTz": "text",
      "originalValueDateTz": "text",
      "investment": "123e4567-e89b-12d3-a456-426614174000"
    }
  ],
  "limit": 1,
  "page": 1,
  "totalItems": 1
}

Account transaction types

Account transaction always alter cash balance. These are the different types you will encounter:

Type	Description
COUPON	Interest payments received from fixed-income securities, such as bonds
DEPOSIT	Cash added to an account by an investor or account holder
DIVIDENDS	Payments made by a corporation to its shareholders, typically from profits
DIVIDEND_RETENTION	Dividends retained by the investment firm or fund instead of being distributed to investors
DIVIDEND_RETENTION_REFUND	Refunds of previously retained dividends, given back to the investors
FEES	Charges deducted from an account for services provided by the financial institution, such as management or transaction fees. They can also be related to an exchange connection commission
FEES_REFUND	Refunds of previously charged fees
FOREX_DEPOSIT	Cash deposits resulting from foreign exchange transactions
FOREX_WITHDRAWAL	Cash withdrawals resulting from foreign exchange transactions
GIFT	Cash received as a gift from the financial institution, like a special promotion
INTEREST	Earnings from interest-bearing accounts or investments
INTEREST_CHARGE	Interest charges deducted from an account, typically related to loans or borrowed funds
RETURN_ON_CAPITAL	Payment that an investor receives as a portion of their original investment and that is not considered income or capital gains from the investment
TAXES	Amounts deducted from an account to pay for taxes
TAX_REFUND	Refunds of previously paid taxes
WITHDRAWAL	Cash removed from an account by the investor or account holder
UNKNOWN	Cash movements that could not be correctly classified