---
title: "Listar exportables"
method: POST
path: "/tools/reports_list_exportables"
tags: ["Reports"]
---

# Listar exportables

`POST /tools/reports_list_exportables`

## Request

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

Herramienta MCP: `reports_list_exportables`.

Devuelve el historial de exportaciones de reportes de la compañía de los últimos 15 días, con su estado (`IN_PROCESS`, `FINISHED`, `FAILED`), filtros, fechas, progreso y nombre de archivo. Solo los exportables en estado `FINISHED` han terminado de generarse.

Paginación por cursor opaco: si `metadata.to` no es null, hay más páginas; llama de nuevo enviando `from` con ese valor. Los administradores ven los exportables de toda la compañía salvo que envíen `own` en true; los demás roles solo ven los suyos.

Úsala para descubrir exportables y obtener el `idExportable` que necesita `reports_get_exportable`: es siempre el paso previo a consultar uno. Si el usuario pregunta cómo va una exportación, si está lista o por sus filtros, consulta `reports_get_exportable` con el ID obtenido aquí. Esta herramienta devuelve estado y metadatos de las exportaciones, no el contenido de los archivos.

Al reportar el progreso de una exportación usa únicamente el campo `progress` (por ejemplo, "va en 67%"); nunca menciones fracciones (4/6), conteos, tareas ni valores inventados a partir del porcentaje.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "reports_list_exportables",
    "arguments": {}
  }
}
```

Todos los parámetros son opcionales: sin ellos devuelve la primera página del historial de los últimos 15 días.

Solo lectura.

## Request body

- object
  - `limit` integer: Tamaño de la página. Si se omite, se usa el valor por defecto de la API.
  - `from` string: Cursor opaco de paginación (`metadata.to` de la página anterior). Omítelo en la primera página.
  - `own` boolean: Si es true, devuelve solo los exportables del usuario autenticado, incluso para administradores. Por defecto false (los administradores ven toda la compañía).

## Response `200`

Página del historial de exportables de los últimos 15 días

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