List invoices
List issued invoices, filtered by date, client or payment status.
GET https://cotlet.dev/api/v1/fatture-in-cloud/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. |
Request
curl "https://cotlet.dev/api/v1/fatture-in-cloud/invoices?payment_status=not_paid&due_before=2026-10-14" \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("fatture-in-cloud", "list_invoices", {"payment_status":"not_paid","due_before":"2026-10-14"})const result = await cotlet.call('fatture-in-cloud', 'list_invoices', {"payment_status":"not_paid","due_before":"2026-10-14"});cotlet call fatture-in-cloud list_invoices --data '{"payment_status":"not_paid","due_before":"2026-10-14"}'Example response
{
"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
}