---
title: "Obtener facturas"
method: POST
path: "/tools/invoice_getInvoices"
tags: ["Invoices"]
---

# Obtener facturas

`POST /tools/invoice_getInvoices`

## Request

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

Herramienta MCP: `invoice_getInvoices`.

Lista facturas de venta con filtros opcionales y paginación (`start` y `limit`, máximo 30 por página).

Por defecto devuelve una versión ligera de cada factura (ids, fechas, estado, numeración, cliente e importes). Usa `detail: true` solo cuando el usuario pida explícitamente ítems, impuestos o pagos.

Para más de unos 120 registros o un rango de fechas completo, usa `invoice_createInvoicesExportable` en lugar de paginar.

Algunos filtros existen solo en ciertos países. Si un parámetro no está disponible en el país de la empresa, omítelo. Solo lectura.

## Request body

- object
  - `client_id` string: ID del cliente. Filtra las facturas de ese cliente.
  - `client_identification` string: Identificación del cliente (RUC, cédula o NIT según el país). Disponible solo en: AR, CO, CR, DO, ES, PA, VE
  - `client_name` string: Nombre del cliente.
  - `date` string: Fecha exacta de creación (YYYY-MM-DD).
  - `date_after` string: Fecha de creación estrictamente posterior a esta fecha (YYYY-MM-DD).
  - `date_afterOrNow` string: Fecha de creación igual o posterior a esta fecha (YYYY-MM-DD). Disponible solo en: AR, CO, CR, DO, ES, VE
  - `date_before` string: Fecha de creación estrictamente anterior a esta fecha (YYYY-MM-DD).
  - `date_beforeOrNow` string: Fecha de creación igual o anterior a esta fecha (YYYY-MM-DD). Disponible solo en: AR, CO, CR, DO, ES, VE
  - `detail` boolean: Si es false (por defecto), devuelve una versión ligera. Si es true, incluye el contenido completo (ítems, impuestos, etc.); úsalo solo si el usuario lo pide.
  - `dueDate` string: Fecha de vencimiento exacta (YYYY-MM-DD).
  - `dueDate_after` string: Fecha de vencimiento estrictamente posterior a esta fecha (YYYY-MM-DD). Disponible solo en: CO
  - `dueDate_afterOrNow` string: Fecha de vencimiento igual o posterior a esta fecha (YYYY-MM-DD). Disponible solo en: CO
  - `dueDate_before` string: Fecha de vencimiento estrictamente anterior a esta fecha (YYYY-MM-DD). Disponible solo en: CO
  - `dueDate_beforeOrNow` string: Fecha de vencimiento igual o anterior a esta fecha (YYYY-MM-DD). Disponible solo en: CO
  - `id` string: Lista separada por comas de IDs de facturas. Si se indica, los demás filtros se ignoran.
  - `item_id` string: Filtra facturas que contengan este ID de ítem. Disponible solo en: AR, CO, CR, DO, ES, VE
  - `limit` integer: Número de facturas por petición (máximo 30).
  - `metadata` boolean: Si es true, devuelve { data: Invoice[], metadata: { total } } en lugar de un arreglo.
  - `numberTemplate_fullNumber` string: Número completo exacto de la factura (por ejemplo, el NCF).
  - `order_direction` 'ASC' | 'DESC': Dirección del orden: ASC (ascendente) o DESC (descendente).
  - `order_field` 'id' | 'name' | 'date' | 'dueDate' | 'status': Campo por el que se ordenan los resultados.
  - `start` integer: Desplazamiento inicial (0 para la primera página, 30 para la segunda).
  - `status` string: Estado de la factura: 'open', 'closed', 'draft' o 'void'. Admite varios valores separados por comas.

## Response `200`

Lista de facturas de venta

## Other responses

- `401`: No autorizado

---

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