Skip to main content
GET
List accounts transactions for the given client

Headers

Auth-Token
string
required

Authentication token provided during the authentication process

Query Parameters

username
string
required

The client's username, as returned by the client list.

bankAccountId
integer<int64>

Limits the response to one connection: banks[].id from the account list. Prefer accountId.

accountId
integer<int64>

The account's id from the account list (banks[].accounts[].id). Without accountId or bankAccountId, the response holds every visible account of the client for that source.

from
string

First day to include, yyyy-MM-dd (MM/dd/yyyy is also accepted). FINICITY filters on the posted date, MX on the transaction date; FDE ignores the date range.

Example:

"2026-07-01"

to
string

Last day to include, yyyy-MM-dd; the whole day is included. FDE ignores it.

Example:

"2026-09-29"

description
string

Returns only transactions whose description contains this text, ignoring case. For MX the bank's original description is matched too. FDE ignores it.

page
integer<int32>
default:0

Page number, starting at 0.

Required range: 0 <= x <= 2147483647
rowsPerPage
enum<integer>
default:50

10, 20 or 50. FINICITY and MX return 50 rows per page for any other value; FDE needs one of the three.

Available options:
10,
20,
50
addOn
boolean
default:false
deprecated

Legacy: true reads FDE when source is not sent. Use source instead.

source
enum<string>
default:FINICITY

Bank-data provider of the account: the bank's source from the account list, in uppercase. Defaults to FINICITY, so an MX account returns no transactions unless source=MX is sent. Takes precedence over addOn.

Available options:
FINICITY,
MX,
FDE

Response

Accounts Transactions data

totalItems
integer<int64>

Number of matching transactions across all pages.

selectedPage
integer<int32>

The page returned, starting at 0. A page past the end returns an empty list.

transactions
object[]