List Invoices
list_invoicesLists company invoices with status, amount, amount still due, due date and days overdue, or reads one invoice with its line items by its id. Answers questions like "what invoices are outstanding?", "what is overdue?", "what does this client owe us?" or "which invoice has been unpaid longest?".
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 |
|---|---|---|---|
| id | No | Return this one invoice in full under `invoice`, by the id an earlier list result gave. The other arguments are then ignored. | |
| limit | No | Max results (1-50, default 20) | |
| status | No | outstanding: still owes something. overdue: owes something and is past its due date. Both list the oldest due date first. The other values match the stored status. Omit for every invoice except voided ones. | |
| clientId | No | Only invoices for this client, by the clientId a project, invoice or deal row gave. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | No | Every invoice that matches, not only the ones returned | |
| invoice | No | Set when id is given | |
| invoices | No |