List invoices
list_invoicesUse this when the user asks to see, find or count their sales invoices: unpaid, overdue, paid, drafts, for a client or a date range ("which invoices are unpaid?"). Lists sales invoices of one business, newest document date first: number, date, due date, status, whether overdue, client name, currency, total, VAT and balance (remaining). status is one of all, draft, sent, overdue, paid, written_off: sent means issued and not yet due; overdue means something is left to pay (remaining above 0) and the due date is before today (UAE time). client_name is the name printed on the invoice; client_current_name appears only when the client was renamed since. On the first page, totals are the invoice list header of the app: count and sum of invoice totals per currency (not balances) of every invoice matching the filter, so with status all they include drafts, which are not issued. No client contact details. Do not use it for one invoice's lines (get_invoice), quotes (list_quotes) or supplier bills (list_bills_due).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_invoices"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Page size, 1 to 50. Default 20. | |
| cursor | No | next_cursor from the previous page, with the same filters. | |
| status | No | One of all, draft, sent, overdue, paid, written_off. Default all. | |
| date_to | No | YYYY-MM-DD, document date on or before. | |
| client_id | No | From list_clients. | |
| date_from | No | YYYY-MM-DD, document date on or after. | |
| business_id | No | From list_businesses. May be left out when the connection shares exactly one business. |