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

# Obtener Datos de Transacciones de Cuentas Bancarias

Lee transacciones bancarias históricas para una cuenta de Plaid vinculada. Estas transacciones son ingeridas y mantenidas por identity-service; TGS las expone en modo de solo lectura.

## Auth

Llama a `/api/v1/graphql` con un token Bearer de usuario de Fluz que incluya `MANAGE_PAYMENT`. La autenticación básica no está permitida en estos campos.

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

## Obtener transacciones

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

**Notas**

* Filtra por `bankAccountId` y una ventana `startDate`/`endDate`; pagina los resultados con `paginate.limit` y `paginate.offset`.
* `totalCount` refleja el total que coincide con el filtro, para construir la paginación.
* `pending: true` marca las transacciones que aún no se han liquidado por completo, los mismos egresos recientes y no liquidados que reducen el poder de gasto disponible de un usuario (ver *Managing Bank Account Spend Power*).

<br />