List invoices
List invoices from the Invoices List by status.
MCP tool aroflo_read → list_invoices
read
Returns one page of invoices with invoice_id, invoice number, client, job number, status, date and total. The two wider business unit options add the owner to each row. Approved invoices are the ones ready for your accounting package. Follow next_cursor until it is null.
Parameters
| Name | Type | Description |
|---|---|---|
| status string | string | In Progress, Pending Approval, Approved or Processed. |
| unpaid_only boolean | boolean | Same as the Unpaid filter on the Invoices List. |
| search string | string | Invoice No, Task Ref, Job Number, Cust. Order No or client name. |
| business_units string | string | This Business Unit Only, Include Child Business Units or Include All Business Units. |
| from string | string | Start date, YYYY-MM-DD. Used with status Processed. |
| to string | string | End date, YYYY-MM-DD. Used with status Processed. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "aroflo_read",
"arguments": {
"operation": "list_invoices",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoices": [
{
"invoice_id": "inv_2041",
"invoice_no": "2041",
"client": "Harbour Café",
"job_number": "J1170",
"status": "Pending Approval",
"date": "2026-10-21",
"total": 840
},
{
"invoice_id": "inv_2043",
"invoice_no": "2043",
"client": "Northside Strata",
"job_number": "J1174",
"status": "Pending Approval",
"date": "2026-10-22",
"total": 2150
},
{
"invoice_id": "inv_2044",
"invoice_no": "2044",
"client": "Kemp Plumbing Supply",
"job_number": "J1179",
"status": "Pending Approval",
"date": "2026-10-22",
"total": 460
}
],
"next_cursor": null
},
"isError": false
}