Getting Bank Account Transaction Data

Read historical bank transactions for a linked Plaid account. These transactions are ingested and maintained by identity-service; TGS exposes them read-only.

Auth

Call /api/v1/graphql with a Fluz user Bearer access token that includes MANAGE_PAYMENT. Basic auth is not allowed on these fields.

Authorization: Bearer <fluz-user-access-token>

Get transactions

query GetPlaidBankTransactions($input: PlaidBankTransactionFilterInput) {
  getPlaidBankTransactions(input: $input) {
    totalCount
    transactions {
      historicalBankTransactionId
      platformItemId
      bankInstitutionAuthId
      bankAccountId
      transactionId
      transactionStatus
      transactionType
      transactionDate
      amount
      currencyCode
      description
      merchantName
      category
      pending
    }
  }
}

{
  "input": {
    "bankAccountId": "bank-account-id",
    "startDate": "2026-01-01T00:00:00.000Z",
    "endDate": "2026-06-04T23:59:59.999Z",
    "paginate": {
      "limit": 50,
      "offset": 0
    }
  }
}

Notes

• Filter by bankAccountId and a startDate/endDate window; page through results with paginate.limit and paginate.offset.
• totalCount reflects the total matching the filter, for building pagination.
• pending: true marks transactions that have not fully settled yet — the same recent, unsettled outflows that reduce a user's available spend power (see Managing Bank Account Spend Power).

Related pages

• Linking a Plaid Bank Account — connect a new account.
• Managing Bank Account Spend Power — read balances and spend power.
• Relinking Disconnected Bank Accounts — repair a dropped connection.