List Invoices
list_invoicesRead-onlyIdempotent
Retrieve a paginated list of invoices with filters for status, client, series, or date range, sorted by newest issue date.
Instructions
List all invoices with optional pagination and filters. Returns a paginated list sorted by issue date (newest first). Supports filtering by status (draft/sent/paid/overdue/cancelled) and date range. Example: status='paid', from='2026-01-01', to='2026-03-31', limit=20 / Lista facturas con paginacion y filtros opcionales. Soporta filtrado por estado y rango de fechas.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| status | No | Filter by invoice status / Filtrar por estado | |
| clientId | No | Filter by client ID / Filtrar por ID de cliente | |
| seriesId | No | Filter by invoice series ID / Filtrar por ID de serie | |
| from | No | Start date filter in ISO 8601 (YYYY-MM-DD) / Fecha inicio | |
| to | No | End date filter in ISO 8601 (YYYY-MM-DD) / Fecha fin | |
| fields | No | Comma-separated field names to return (e.g. 'id,clientName,total') / Campos a devolver | |
| limit | No | Max results per page (1-100, default 50) / Resultados por pagina | |
| offset | No | Number of results to skip / Resultados a saltar | |
| after | No | Cursor for cursor-based pagination (document ID) / Cursor para paginacion basada en cursor |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| total | Yes | ||
| limit | Yes | ||
| offset | Yes | ||
| nextCursor | No |