---
title: "Listar cuentas bancarias"
method: POST
path: "/tools/banks_getBanks"
tags: ["Banks"]
---

# Listar cuentas bancarias

`POST /tools/banks_getBanks`

## Request

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

Herramienta MCP: `banks_getBanks`.

Lista las cuentas bancarias y de caja 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_getBanks",
    "arguments": { "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`), búsqueda por texto con `query` o `name`, y filtros por `status` (`active` o `inactive`) y `type` (`bank`, `cash`, `credit-card`, `foreign-account`).

Con `metadata: true` (valor por defecto) la respuesta es `{ metadata: { total }, data: [...] }` e incluye el total de cuentas; con `includeBalance: true` añade el saldo de cada cuenta y con `includeInactive: true` incluye las cuentas inactivas. Con `fields` puedes ampliar cada cuenta con información adicional separada por comas (`deletable`, `journal`, `lastMovementDate`, `category`).

Úsala para descubrir los `id` de las cuentas que necesitan `banks_getBanksById`, `banks_getReconciliations` o `banks_getTransactions`. Para buscar una cuenta por su nombre exacto, usa `banks_getBanksByName`.

Notas por país: el tipo `foreign-account` (cuenta en moneda extranjera) solo está disponible en México; en el resto de países `type` acepta únicamente `bank`, `cash` y `credit-card`.

Solo lectura.

## Request body

- object
  - `fields` 'deletable' | 'journal' | 'lastMovementDate' | 'category': Campos adicionales a incluir en la respuesta: deletable, journal, lastMovementDate o category.
  - `includeBalance` boolean: Incluye el saldo de cada cuenta bancaria.
  - `includeInactive` boolean: Incluye las cuentas inactivas.
  - `limit` integer: Cantidad de cuentas a consultar. Máximo 30.
  - `metadata` boolean: Si es true (valor por defecto), la respuesta es { metadata: { total }, data: [...] } e incluye el total de cuentas.
  - `name` string: Filtra por nombre del banco o de la cuenta.
  - `order_direction` 'ASC' | 'DESC': Dirección del orden: ASC (ascendente) o DESC (descendente).
  - `order_field` 'id' | 'date': Campo por el cual se ordenan los resultados: id o date.
  - `query` string: Texto libre para buscar cuentas.
  - `start` integer: A partir de cuál cuenta se desea consultar (0 para la primera página).
  - `status` 'active' | 'inactive': Filtra por estado de la cuenta: active o inactive.
  - `type` 'bank' | 'cash' | 'credit-card' | 'foreign-account': Filtra por tipo de cuenta: bank, cash, credit-card o foreign-account. El tipo foreign-account solo aplica en México.

## Response `200`

Lista de cuentas 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)