List invoices
Sales invoices for a date range, with totals, payment and KSeF status.
MCP tool ifirma_read → list_invoices
read
Returns invoices issued in the range you choose. Each item has number, buyer, issue and due date, gross amount, currency, amount paid, draft and sent flags, and the KSeF number and status. Without date_to the range is 30 days from date_from. Pages hold 20 results unless you set per_page.
Parameters
| Name | Type | Description |
|---|---|---|
| date_from string required | string | YYYY-MM-DD, the first issue date. |
| date_to string | string | YYYY-MM-DD. Default: 30 days after date_from. |
| status string | string | overdue, unpaid, partly_paid or paid. Several values can be joined with commas. |
| contractor_id string | string | Contractor ID from list_contractors. |
| nip string | string | Buyer tax number (NIP). |
| min_amount number | number | Smallest document value. |
| max_amount number | number | Largest document value. |
| page integer | integer | Page number. Default: 1. |
| per_page integer | integer | Results per page. Default: 20. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "ifirma_read",
"arguments": {
"operation": "list_invoices",
"arguments": {
"date_from": "date from"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoices": [
{
"id": 7020118,
"number": "41/2026",
"buyer": "Blue Fern Studio",
"contractor_id": "c_4817",
"issue_date": "2026-10-14",
"due_date": "2026-10-28",
"gross": 1230,
"currency": "PLN",
"paid": 0,
"draft": false,
"sent": false,
"ksef_status": null
},
{
"id": 7020104,
"number": "39/2026",
"buyer": "Harbor Print Ltd",
"contractor_id": "c_4832",
"issue_date": "2026-09-18",
"due_date": "2026-10-02",
"gross": 800,
"currency": "PLN",
"paid": 0,
"draft": false,
"sent": true,
"ksef_status": "accepted"
}
],
"page": 1
},
"isError": false
}