List invoices
Sales invoices with number, client, total, due date and payment status, oldest due date first.
MCP tool holded_read → list_invoices
read
Lists sales invoices, oldest due date first. Status unpaid returns invoices that are pending or overdue, paid returns settled ones and all returns both. Filter by contact, issue date or due date to find what is late. Each item shows the total, what is still open and whether it is a draft. Pages hold up to 100 invoices; pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | unpaid (pending and overdue), paid or all. Default: all. |
| contact_id string | string | Only invoices of this contact. |
| issued_since date | date | Only invoices dated on or after this date. |
| due_before date | date | Only invoices due before this date. |
| limit integer | integer | 1 to 100. Default: 50. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "holded_read",
"arguments": {
"operation": "list_invoices",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoices": [
{
"invoice_id": "inv_7d31",
"number": "INV-0045",
"contact": "Northwind Studio",
"total": 968,
"open": 968,
"currency": "EUR",
"issued": "2026-09-14",
"due_date": "2026-10-14",
"status": "overdue",
"draft": false
}
],
"next_cursor": null
},
"isError": false
}