List invoices
Sales or cost invoices for a period, with status, totals and due date.
MCP tool fakturownia_read → list_invoices
read
Returns invoices for the period you choose, newest issue date first unless you set order. Each item has number, kind, status, buyer, net, VAT and gross totals, due date and paid amount. Fakturownia pages results at up to 100 per page. Set income to false for cost invoices.
Parameters
| Name | Type | Description |
|---|---|---|
| period string | string | this_month, last_30_days, last_month, this_year, last_year, last_12_months, all or more. Default: this_month. |
| date_from string | string | YYYY-MM-DD. Needed when period is more. |
| date_to string | string | YYYY-MM-DD. Needed when period is more. |
| status string | string | Keep only invoices with this status: issued, sent, partial, paid or rejected. |
| kind string | string | Document kind, for example vat, proforma, advance, correction, estimate. |
| income boolean | boolean | false returns cost invoices. Default: true. |
| client_id integer | integer | Only invoices of this client, from list_clients. |
| page integer | integer | Page number. Default: 1. |
| per_page integer | integer | 1 to 100. Default: the app default. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "fakturownia_read",
"arguments": {
"operation": "list_invoices",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoices": [
{
"id": 5120,
"number": "14/10/2026/1",
"kind": "vat",
"status": "issued",
"buyer_name": "Blue Fern Studio",
"price_net": "1000.00",
"price_tax": "230.00",
"price_gross": "1230.00",
"currency": "PLN",
"issue_date": "2026-10-14",
"payment_to": "2026-10-28",
"paid": "0.00"
},
{
"id": 5104,
"number": "09/10/2026/3",
"kind": "vat",
"status": "partial",
"buyer_name": "Harbor Print Ltd",
"price_net": "650.41",
"price_tax": "149.59",
"price_gross": "800.00",
"currency": "PLN",
"issue_date": "2026-10-09",
"payment_to": "2026-10-23",
"paid": "500.00"
}
],
"page": 1
},
"isError": false
}