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

# 获取银行账户交易数据

读取已链接 Plaid 账户的历史银行交易。这些交易由 identity-service 摄取并维护；TGS 以只读方式对外提供。

## Auth

使用包含 `MANAGE_PAYMENT` 的 Fluz 用户 Bearer 访问令牌调用 `/api/v1/graphql`。这些字段不允许使用基本身份验证（Basic auth）。

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

## 获取交易

```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
    }
  }
}
```

**说明**

* 通过 `bankAccountId` 和 `startDate`/`endDate` 时间窗进行筛选；使用 `paginate.limit` 和 `paginate.offset` 对结果分页。
* `totalCount` 反映与筛选条件匹配的总数，用于构建分页。
* `pending: true` 表示尚未完全清算的交易——这些与最近的、未结清的支出相同，会减少用户的可用消费能力（参见 *Managing Bank Account Spend Power*）。

<br />