---
title: "Listar movimientos de una cuenta bancaria"
method: POST
path: "/tools/banks_getTransactions"
tags: ["Banks"]
---

# Listar movimientos de una cuenta bancaria

`POST /tools/banks_getTransactions`

## Request

- Base URL: `https://mcp.alegra.com`
- URL: `https://mcp.alegra.com/tools/banks_getTransactions`
- Auth: HTTP bearer

Herramienta MCP: `banks_getTransactions`.

Lista los movimientos de una cuenta bancaria: transacciones, comprobantes de diario y ajustes por diferencia en cambio.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "banks_getTransactions",
    "arguments": { "bankAccountId": "12", "dateFrom": "2026-09-01", "dateTo": "2026-09-30" }
  }
}
```

Requiere `bankAccountId`, el identificador de la cuenta cuyos movimientos se desean listar; obténlo con `banks_getBanks` o `banks_getBanksByName` cuando el usuario se refiera a la cuenta por su nombre.

Soporta paginación con `start` y `limit` (hasta 30 por página), rango de fechas con `dateFrom` y `dateTo` (YYYY-MM-DD) y filtro por sentido del movimiento con `type` (`in` para entradas, `out` para salidas).

Úsala para revisar el flujo de una cuenta en un período, conciliar sus movimientos o auditar entradas y salidas. Para consultar la cuenta misma, usa `banks_getBanksById`.

Solo lectura.

## Request body

- object
  - `bankAccountId` string, required: Identificador de la cuenta bancaria cuyos movimientos se listarán.
  - `dateFrom` string: Filtra movimientos desde esta fecha (YYYY-MM-DD).
  - `dateTo` string: Filtra movimientos hasta esta fecha (YYYY-MM-DD).
  - `type` 'in' | 'out': Filtra por tipo de movimiento: in (entrada) u out (salida).
  - `start` integer: A partir de cuál movimiento se desea consultar (0 para la primera página).
  - `limit` integer: Cantidad de movimientos a consultar. Máximo 30.

## Response `200`

Lista de movimientos de la cuenta bancaria

## Other responses

- `401`: No autorizado (token de Alegra inválido o expirado).

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)