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.

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

Obtener transacciones

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

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

​Auth

​Obtener transacciones

Auth

Obtener transacciones