List invoices
Invoices with status, amount due, due date and last send date, filtered like the Invoice list.
MCP tool housecall_pro_read → list_invoices
read
Lists invoices the way the Invoice list does. Status is Open, Paid, Pending, Canceled or Voided, and Open includes partially paid invoices. Use filter past_due for invoices not paid by their due date, or unsent for Open invoices with no send record. Pages hold up to 100 invoices.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | open, paid, pending, canceled or voided. |
| filter enum | enum | all, unsent, due or past_due. Default: all. |
| customer_id string | string | Only invoices for this customer. |
| due_before date | date | Only invoices due before this date. |
| limit integer | integer | 1 to 100. Default: 50. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "housecall_pro_read",
"arguments": {
"operation": "list_invoices",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoices": [
{
"invoice_id": "inv_7c20be",
"job_id": "job_30b9f1",
"customer": {
"customer_id": "cus_20d8aa",
"name": "Marcus Lee"
},
"status": "open",
"amount": 780,
"amount_due": 780,
"due_date": "2026-10-02",
"last_sent_at": "2026-09-18T09:12:00-05:00"
}
],
"next_cursor": null
},
"isError": false
}