> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# 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.

```http theme={null}
Authorization: Bearer <fluz-user-access-token>
```

## Get transactions

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

```json theme={null}
{
  "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*).

<br />