---
title: "Listar conciliaciones bancarias"
method: POST
path: "/tools/banks_getReconciliations"
tags: ["Banks"]
---

# Listar conciliaciones bancarias

`POST /tools/banks_getReconciliations`

## Request

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

Herramienta MCP: `banks_getReconciliations`.

Lista las conciliaciones bancarias de la compañía con filtros opcionales y paginación.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "banks_getReconciliations",
    "arguments": { "status": "open", "limit": 10 }
  }
}
```

Soporta paginación con `start` y `limit` (hasta 30 por página), orden con `order_field` (`id` o `date`) y `order_direction` (`ASC` o `DESC`), filtro por cuenta con `account_id`, por fecha exacta con `date` (YYYY-MM-DD) y por estado con `status` (`open`, `draft` o `process`).

Con `metadata: true` (valor por defecto) la respuesta incluye el total de conciliaciones. Con `fields` puedes ampliar la respuesta con información adicional (`deletable`, `balance` o `simple`; en modo `simple` se omiten las transacciones de cada conciliación).

Úsala para descubrir los `id` que necesita `banks_getReconciliationById` o para revisar las conciliaciones `open` o en `process` de una cuenta. Los `id` de las cuentas se obtienen con `banks_getBanks`.

Solo lectura.

## Request body

- object
  - `account_id` string: Identificador de la cuenta bancaria. Limita la lista a las conciliaciones de esa cuenta.
  - `start` integer: A partir de cuál conciliación se desea consultar (0 para la primera página).
  - `limit` integer: Cantidad de conciliaciones a consultar. Máximo 30.
  - `order_direction` 'ASC' | 'DESC': Orden ascendente o descendente para el listado de conciliaciones.
  - `order_field` 'id' | 'date': Campo por el cual se desea ordenar: id o date.
  - `fields` 'deletable' | 'balance' | 'simple': Información adicional: deletable, balance o simple (modo simple sin transactions).
  - `metadata` boolean: Incluye en la respuesta el total de conciliaciones.
  - `date` string: Filtra conciliaciones por fecha exacta en formato YYYY-MM-DD.
  - `status` 'open' | 'draft' | 'process': Filtra conciliaciones por estado: open, draft o process.

## Response `200`

Lista de conciliaciones bancarias

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