List fund transfers
Operation ID: fundTransfers
Group: Banking › Fund Transfers
Open in the interactive reference
GET /banking/fund-transfers
Read-only: Reads and returns; changes nothing.
Lists fund transfers. The collection doesn't include lines, exchangeRate, externalUrl, journalEntryNumber, or the account and legal entity ids. To get these fields, use GET banking/fund-transfers/:id or POST banking/fund-transfers/search. To filter by fromAccountId, toAccountId, entityId, entityName, or journalEntryNumber, use POST banking/fund-transfers/search.
Parameters
| Name | In | Type | Required | Description |
|---|---|---|---|---|
Api-Version |
header | string · v1 | yes | The API version this request targets, named by its public identifier. Required on every request; omitting it, or naming a version this company does not have, is answered with 400. This document describes version v1. |
Query surface
id— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likefundTransferNumber— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, liketransferDate— filter by eq, ne, gt, gte, lt, lte, in, notIn, betweencurrency— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likeisVoided— filter by eq, ne, gt, gte, lt, lte, in, notIn, betweenisIntercompany— filter by eq, ne, gt, gte, lt, lte, in, notIn, betweenorigin— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likeexternalPaymentId— filter by eq, ne, gt, gte, lt, lte, in, notIn, between, likelastModifiedDate— filter by eq, ne, gt, gte, lt, lte, in, notIn, between- Orderable: id, fundTransferNumber, transferDate, transferAmount, currency, isVoided, isIntercompany, lastModifiedDate
- Selectable: id, fundTransferNumber, name, description, transferDate, transferAmount, currency, isVoided, isIntercompany, origin, externalPaymentId, fromAccountName, toAccountName, entityName, toEntityName, lastModifiedDate
page[size]— Page sizepage[cursor]— Opaque continuation cursor
Response
200 Success
Under data, an array of fundTransfersRow:
| Field | Type | Required | Filter | Sort | Description |
|---|---|---|---|---|---|
id |
string | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
yes | The unique identifier for the fund transfer. |
fundTransferNumber |
string | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
yes | The fund transfer number, for example 'FT-71122'. Absent while none has been assigned. |
name |
string | null | no | no | no | The display name of the fund transfer. |
description |
string | null | no | no | no | A free-form description of the transfer. |
transferDate |
date | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) |
yes | The date the money moved. Format YYYY-MM-DD. |
transferAmount |
decimal | null | no | no | yes | The amount moved, in the transfer currency. |
currency |
string | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
yes | The transfer currency. Format ISO 4217, for example 'USD'. transferAmount is in this currency. |
isVoided |
boolean | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) |
yes | Whether the transfer has been voided. A voided transfer is kept for audit rather than deleted. |
isIntercompany |
boolean | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) |
yes | Whether the transfer moves money between two legal entities rather than between two accounts of one entity. When true, toEntityId names the receiving entity. |
origin |
string | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
no | The system or process the transfer came from. |
externalPaymentId |
string | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn), Pattern (like) |
no | The identifier of this payment in the external system that initiated the transfer. It is not unique. |
fromAccountName |
string | null | no | no | no | The name of the account the money left. |
toAccountName |
string | null | no | no | no | The name of the account the money arrived in. |
entityName |
string | null | no | no | no | The name of the legal entity the transfer is posted under. |
toEntityName |
string | null | no | no | no | The name of the receiving legal entity on an intercompany transfer. |
lastModifiedDate |
date-time | null | no | Exact (eq, ne), Range (gt, gte, lt, lte, between), Any of (in, notIn) |
yes | The date and time the fund transfer last changed, in UTC. Format YYYY-MM-DDTHH:mm:ss.sssZ. |
{
"data": [
{
"id": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"fundTransferNumber": "<fundTransferNumber>",
"name": "<name>",
"description": "<description>",
"transferDate": "2026-01-15",
"transferAmount": "19.99",
"currency": "<currency>",
"isVoided": true,
"isIntercompany": true,
"origin": "<origin>",
"externalPaymentId": "3fa85f64-5717-4562-b3fc-2c963f66afa6",
"fromAccountName": "<fromAccountName>",
"toAccountName": "<toAccountName>",
"entityName": "<entityName>",
"toEntityName": "<toEntityName>",
"lastModifiedDate": "2026-01-15T09:30:00.000Z"
}
],
"pagination": {
"hasMore": true,
"nextCursor": "<nextCursor>"
}
}
Statuses
400— Invalid request or business failure401— The request carries no valid access token.403— Not authorized404— Not found429— Too many requests from this client address. The response has no body and noRetry-Afterheader.500— Internal server error