List invoices
List issued invoices, filtered by date, client or payment status.
MCP tool fatture_in_cloud_read → list_invoices
read
Returns issued invoices with number, date, client, net, VAT and gross amounts and payment status, newest first. Use page and per_page to move through long lists. Needs read access to issued invoices.
Parameters
| Name | Type | Description |
|---|---|---|
| company_id integer | integer | Company ID. Optional when your account has one company. |
| date_from string | string | ISO date. Invoices dated on or after it. |
| date_to string | string | ISO date. Invoices dated on or before it. |
| client_id integer | integer | Only invoices of this client, from list_clients. |
| payment_status string | string | not_paid or paid. |
| due_before string | string | ISO date. Only invoices with an open payment due before it. |
| page integer | integer | Page number, starting at 1. Default: 1. |
| per_page integer | integer | Results per page. Default: 50. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "fatture_in_cloud_read",
"arguments": {
"operation": "list_invoices",
"arguments": {
"payment_status": "not_paid",
"due_before": "2026-10-14"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoices": [
{
"id": 88120,
"number": 14,
"date": "2026-10-02",
"client": "Rossi Consulting SRL",
"amount_net": 1500,
"amount_vat": 330,
"amount_gross": 1830,
"payment_status": "not_paid",
"due_date": "2026-11-01"
},
{
"id": 88121,
"number": 15,
"date": "2026-10-03",
"client": "Studio Verdi SRL",
"amount_net": 800,
"amount_vat": 176,
"amount_gross": 976,
"payment_status": "paid",
"due_date": "2026-10-18"
}
],
"page": 1
},
"isError": false
}