List invoices
Invoices with status, amount due, due date and last send date, filtered like the Invoice list.
GET https://cotlet.dev/api/v1/housecall-pro/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. |
Request
curl https://cotlet.dev/api/v1/housecall-pro/invoices \
-H "Authorization: Bearer $COTLET_API_KEY"result = client.call("housecall-pro", "list_invoices")const result = await cotlet.call('housecall-pro', 'list_invoices');cotlet call housecall-pro list_invoicesExample response
{
"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
}