---
title: "Obtener facturas recurrentes"
method: POST
path: "/tools/recurringInvoices_getRecurringInvoices"
tags: ["Sales Documents"]
---

# Obtener facturas recurrentes

`POST /tools/recurringInvoices_getRecurringInvoices`

## Request

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

Herramienta MCP: `recurringInvoices_getRecurringInvoices`.

Lista facturas recurrentes (paginadas, máximo 30 por página). Permite filtrar por nombre del cliente (`name`, coincidencia de nombre, no ID), cliente (`client_id`), fechas de inicio y fin de la recurrencia (`startDate`/`endDate`), intervalo (`repeatEvery`), condición de pago (`term`) y estado (`status`).

El filtro `status` solo acepta `draft` o `open` — mapea tú mismo la petición en lenguaje natural del usuario (por ejemplo \"borrador\"/\"pendiente\" → `draft`; \"abierta\"/\"activa\"/\"emitida\" → `open`); cualquier otro valor se rechaza con un 400 (`statusIsInvalid`). \"draft\" incluye también registros antiguos sin atributo de estado; \"open\" es estricto. Este filtro es transversal en todos los países. Con `metadata: true` la respuesta se envuelve como `{ data: [...], metadata: { total } }` en lugar de un arreglo simple.

Solo lectura.

## Request body

- object
  - `start` integer: Desplazamiento basado en cero para la paginación. Usa `limit` * número de página para saltar páginas.
  - `limit` integer: Máximo de facturas recurrentes por página (por defecto 30).
  - `order_direction` 'ASC' | 'DESC': Dirección del orden: "ASC" ascendente, "DESC" descendente.
  - `order_field` string: Nombre del campo por el que se ordena (por ejemplo "startDate", "nextCreation").
  - `name` string: Filtra por nombre del cliente (coincidencia de nombre, no ID de cliente).
  - `client_id` string: Filtra por ID del cliente.
  - `startDate` string: Filtra por la fecha de inicio de la recurrencia (YYYY-MM-DD).
  - `endDate` string: Filtra por la fecha de fin de la recurrencia (YYYY-MM-DD).
  - `repeatEvery` integer: Filtra por el intervalo de la recurrencia, en meses (por ejemplo 2 = cada 2 meses).
  - `term` integer: Filtra por el ID de la condición de pago.
  - `status` 'draft' | 'open': Filtra por estado. Transversal en todos los países. Solo se aceptan "draft" u "open" — cualquier otro valor lo rechaza la API con un 400 (statusIsInvalid), así que mapea tú mismo la petición en lenguaje natural: "borrador"/"draft"/"pendiente" → "draft"; "abierta"/"activa"/"emitida"/"open" → "open" — nunca pases sin más un valor crudo que el usuario escribió. "draft" incluye también registros antiguos sin atributo de estado; "open" es estricto.
  - `metadata` boolean: Si es true, envuelve la respuesta como { data: [...], metadata: { total } } en lugar de un arreglo simple.

## Response `200`

Lista de facturas recurrentes

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