List invoices
Sales or cost invoices for a period, with status, totals and due date.
GET https://cotlet.dev/api/v1/fakturownia/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. |
Request
curl https://cotlet.dev/api/v1/fakturownia/invoices \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("fakturownia", "list_invoices")const result = await cotlet.call('fakturownia', 'list_invoices');cotlet call fakturownia list_invoicesExample response
{
"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
}