Get invoice
One invoice with line items, amount due, payment history and send history.
MCP tool housecall_pro_read → get_invoice
read
Returns one invoice as the invoice preview shows it: the lines, the amount due, each payment applied with its method and date, and when the invoice was last sent. A payment that has not reached the bank, such as an ACH payment, appears with pending status. Use it before resending or recording a payment.
Parameters
| Name | Type | Description |
|---|---|---|
| invoice_id string required | string | Invoice ID from list_invoices or get_job. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "housecall_pro_read",
"arguments": {
"operation": "get_invoice",
"arguments": {
"invoice_id": "invoice_8c41d2"
}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"invoice_id": "inv_7c20be",
"job_id": "job_30b9f1",
"status": "open",
"line_items": [
{
"name": "Drain cleaning, kitchen",
"quantity": 1,
"unit_price": 780
}
],
"amount": 780,
"amount_due": 780,
"due_date": "2026-10-02",
"payments": [],
"sent": [
{
"sent_at": "2026-09-18T09:12:00-05:00",
"channel": "email"
}
],
"online_payment_enabled": true
},
"isError": false
}