---
title: "Listar comprobantes contables"
method: POST
path: "/tools/accounting_listJournals"
tags: ["Accounting"]
---

# Listar comprobantes contables

`POST /tools/accounting_listJournals`

## Request

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

Herramienta MCP: `accounting_listJournals`.

Lista los comprobantes contables 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": "accounting_listJournals",
    "arguments": { "limit": 10 }
  }
}
```

Soporta paginación por `start` y `limit` (hasta 30 por página, 30 por defecto), orden con `order_field` y `order_direction` (`ASC` o `DESC`, ascendente por defecto), y filtros por fecha exacta con `date` (YYYY-MM-DD), cliente con `client_name` o `client_id`, texto parcial con `reference` u `observations`, numeración con `id` o `number`, tipo de comprobante con `type` (por ejemplo `closing-period`) y estado con `status` (`open` o `void`).

Con `fields` puedes ampliar cada comprobante con información adicional separada por comas (`type`, `numberTemplate`) y con `format: simple` se omite el detalle pesado de las líneas del comprobante.

Úsala como punto de partida para descubrir los `id` de los comprobantes que necesitan `accounting_getJournal` o `accounting_getJournalEntriesGraph`, o para revisar los comprobantes de una fecha o cliente concretos.

Solo lectura.

## Request body

- object
  - `start` integer: Desde qué comprobante consultar (0 para la primera página).
  - `limit` integer: Cantidad de comprobantes a retornar. Máximo 30, por defecto 30.
  - `order_direction` 'ASC' | 'DESC': Orden ascendente o descendente. Por defecto ASC.
  - `order_field` string: Campo por el cual ordenar: date, name, reference u observations. Valores pendientes de verificar con una llamada real.
  - `date` string: Filtra por fecha exacta del comprobante en formato YYYY-MM-DD.
  - `client_name` string: Filtra por nombre del cliente (búsqueda parcial).
  - `reference` string: Filtra por referencia (búsqueda parcial).
  - `observations` string: Filtra por observaciones (búsqueda parcial).
  - `client_id` string: Filtra por id del cliente.
  - `id` string: Filtra por número del comprobante.
  - `number` string: Filtra por numeración del comprobante.
  - `type` string: Filtra por tipo de comprobante, por ejemplo closing-period. Valores pendientes de verificar con una llamada real.
  - `status` 'open' | 'void': Filtra por estado del comprobante: open o void.
  - `fields` string: Campos adicionales separados por coma: type, numberTemplate.
  - `format` 'simple': Formato simple para evitar cargar líneas/detalle pesado del comprobante.

## Response `200`

Lista de comprobantes contables

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