--- title: "Get transactions" method: GET path: "/ledger/v1/transactions" tags: ["Wallets"] --- # Get transactions `GET /ledger/v1/transactions` ## Request - Base URL: `https://api.sandbox.bvnk.com` - URL: `https://api.sandbox.bvnk.com/ledger/v1/transactions` - Auth: API key in header `Authorization` - TypeScript: (a function with typed inputs; its response is checked against the schema) Retrieves a paginated list of transactions for a specific wallet. Supports filtering by `walletId` and optional date range. The date range can be applied to the `createdAt` or `updatedAt` timestamp, determined by the `filterMode`. If omitted, the `filterMode` defaults to `CREATED_AT`. Refer to the [Fiat payments guide](https://docs.bvnk.com/bvnk/reconciliation/reconcile-transactions#retrieve-transaction-history). ## Query parameters - `walletId` string, required - `statuses` string[] - `page` integer - `size` integer - `filterMode` 'CREATED_AT' | 'UPDATED_AT': Specifies whether the date range should be applied to the `createdAt` or `updatedAt` timestamp. - `start` string, date-time - `end` string, date-time ## Response `200` Paginated list of transactions - object - `content` object[] - `transactionId` string: Unique reference for the transaction. - `paymentId` string: Unique reference for the payment. - `paymentReference` string: Reference label to identify or describe the payment. - `type` 'PAYOUT' | 'PAYIN' | 'FEE' | 'internalTransfer' | 'paymentOut' | 'channelDeposit' | 'reversal': Type of transaction which is being listed. - Fiat only: `PAYOUT`, `PAYIN`, `FEE`. - Crypto only: `paymentOut`, `channelDeposit`, `reversal`. - Both crypto and fiat: `internalTransfer`. - `status` 'DETECTED' | 'PROCESSING' | 'COMPLETED' | 'PENDING_APPROVAL' | 'ON_HOLD' | 'RETURNED' | 'EXPIRED' | 'CANCELLED' | 'FAILED': Current processing state of the transaction. - `statusDetails` string: Additional details about the current transaction status. Returned only when `status` is `FAILED`. - `walletId` string: Unique identifier of the wallet for this transaction. - `amount` object: Total amount and currency of the transaction. - `value` number: Numeric value of the transaction. - `currencyCode` 'USD' | 'EUR' | 'GBP': Currency in ISO 4217 format. - `runningBalance` object: Real-time balance of the wallet immediately after this transaction. - `value` number: Updated balance amount. - `currencyCode` 'USD' | 'EUR' | 'GBP': Currency code of the updated balance. - `originator` object: Entity that initiated the transaction and sent the funds. - `entity` object: Sender (originator) identity information. - `type` 'COMPANY' | 'INDIVIDUAL': Type of sender entity. - `name` string: Name of the sender for companies. - `firstName` string: First name of the sender for individuals. - `lastName` string: Last name of the sender for individuals. - `bankAccount` object: Bank account, from which the payment was initiated. - `accountNumber` string: Account number of the sender. - `bankCode` string: Bank code of the sender. - `bankName` string: Name of the sender's bank. Null if this detail has not been enriched for the transaction. - `walletId` string: Unique identifier of the originator's wallet. - `amount` object: Amount sent by the originator. For crypto payments. - `value` number: Numeric value of the amount. - `currencyCode` string: Currency in ISO 4217 or crypto ticker (e.g., USD, USDT). - `beneficiary` object: Recipient of the transaction. - `entity` object: Entity information about the recipient. - `type` 'COMPANY' | 'INDIVIDUAL': Type of recipient entity. - `name` string: Name of the recipient for companies. - `firstName` string: First name of the recipient for individuals. - `lastName` string: Last name of the recipient for individuals. - `bankAccount` object: Bank account that received the payment. - `accountNumber` string: Account number of the recipient. - `bankCode` string: Bank code of the recipient. - `walletId` string: Unique identifier of the beneficiary's wallet. - `cryptoAddresses` object: Crypto destination addresses. For crypto payments. - `addresses` string[]: List of blockchain addresses. - `protocol` string: Protocol or token standard (e.g., TRC20, ERC20). - `network` string: Blockchain network (e.g., TRON, ETHEREUM). - `amount` object: Amount received by the beneficiary. For crypto payments. - `value` number: Numeric value of the amount. - `currencyCode` string: Currency in ISO 4217 or crypto ticker (e.g., USD, USDT). - `details` object: Additional transaction information. - `paymentMethod` 'SEPA_CT' | 'SEPA_INST' | 'FASTER_PAYMENT' | 'ACH' | 'ACH_SAME_DAY' | 'FEDWIRE' | 'BOOK' | 'SWIFT' | 'UNKNOWN': Payment channel used for the transaction. - `fxRate` object: Foreign exchange details applied when a transaction involves currency conversion (including crypto to fiat or crypto to crypto). Only for crypto transactions. - `baseCurrency` string: Base currency code for the conversion. Uses ISO 4217 for fiat or common crypto tickers (e.g., BTC, USDT) for digital assets. - `counterCurrency` string: Counter currency code for the conversion. Uses ISO 4217 for fiat or common crypto tickers (e.g., BTC, USDT) for digital assets. - `merchantFxRate` number: Effective rate applied to the merchant to convert baseCurrency to counterCurrency. - `baseFxRate` number: Underlying market reference rate for the currency pair at the time of conversion. - `merchantSpread` number: The spread applied by BVNK (merchantFxRate - baseFxRate), expressed as a fraction (e.g., 0.002 = 0.2%). - `complianceDetail` object: Compliance context/details captured for a crypto transaction. Only for crypto transactions. - `hash` string: Blockchain transaction hash. Only for crypto transactions. - `exchangeRate` number: Exchange rate applied for the transaction. For crypto payments. - `createdAt` string, date-time: The timestamp when the transaction was created. - `updatedAt` string, date-time: The timestamp of the transaction's most recent update. - `pageable` object - `pageNumber` integer - `pageSize` integer - `offset` integer - `paged` boolean - `unpaged` boolean - `last` boolean - `totalElements` integer - `totalPages` integer - `first` boolean - `size` integer - `number` integer - `sort` string[] - `numberOfElements` integer - `empty` boolean ## Changes - **2026-11-06** `c386d436bf2c`: 2 info - added the optional property `content/items/originator/bankAccount/bankName` to the response with the `200` status - added the optional property `content/items/statusDetails` to the response with the `200` status - **2026-06-16** `97d6c0d2fe2e`: 1 warning, 6 info - removed the optional property `content/items/beneficiary/entity/walletId` from the response with the `200` status - added the optional property `content/items/beneficiary/amount` to the response with the `200` status - added the optional property `content/items/beneficiary/cryptoAddresses` to the response with the `200` status - added the optional property `content/items/beneficiary/walletId` to the response with the `200` status - …3 more [Operation history](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/changes/ledger/v1/transactions/get.md) --- [API](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints.md) - [All operations](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/llms.txt) - [OpenAPI document](https://skmtc.dev/bvnk/apis/bvnk-api-endpoints/revisions/c386d436bf2c?raw)