List customer invoices
Customer invoices with number, customer, amounts, status and due date, newest first.
MCP tool pennylane_read → list_customer_invoices
read
Lists customer invoices, newest first. Status is one of draft, upcoming, late, partially_paid or paid, and remaining_amount_with_tax is the amount still owed on that invoice. Pennylane's own invoice list cannot filter by status or due date, so Cotlet applies the status filter for you. Pages hold 1 to 100 invoices; pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | draft, upcoming, late, partially_paid or paid. Default: all. |
| customer_id integer | integer | Customer ID from list_customers. |
| date_from date | date | Only invoices dated on or after this day. |
| date_to date | date | Only invoices dated on or before this day. |
| external_reference string | string | Only the invoice created with this external reference. |
| limit integer | integer | 1 to 100. Default: 20. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "pennylane_read",
"arguments": {
"operation": "list_customer_invoices",
"arguments": {
"status": "late",
"limit": 50
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoices": [
{
"invoice_id": 118342,
"invoice_number": "F-2026-0148",
"customer": {
"customer_id": 4021,
"name": "Atelier Lumen SARL"
},
"date": "2026-09-15",
"deadline": "2026-09-30",
"amount": "2400.00",
"remaining_amount_with_tax": "2400.00",
"status": "late",
"currency": "EUR"
},
{
"invoice_id": 118301,
"invoice_number": "F-2026-0139",
"customer": {
"customer_id": 4034,
"name": "Studio Marais SAS"
},
"date": "2026-09-20",
"deadline": "2026-10-05",
"amount": "960.00",
"remaining_amount_with_tax": "960.00",
"status": "late",
"currency": "EUR"
},
{
"invoice_id": 118277,
"invoice_number": "F-2026-0131",
"customer": {
"customer_id": 4012,
"name": "Brasserie du Port"
},
"date": "2026-09-23",
"deadline": "2026-10-08",
"amount": "1368.00",
"remaining_amount_with_tax": "1368.00",
"status": "late",
"currency": "EUR"
}
],
"total_remaining_with_tax": "4728.00",
"has_more": false,
"next_cursor": null
},
"isError": false
}