List invoices
billy_list_invoicesRead-only
List sales invoices and credit notes (newest first by default): number, date, due date, state (draft/approved/voided), amount, tax, balance, isPaid, contactId, currency. Filter by state, customer, number, date, period, paid status or free text. Paged. GET /invoices.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free-text search over invoice number, order number, contact name, line description, amount. | |
| page | No | Page number, 1-based (default 1). Use next_page from the previous reply. | |
| state | No | Only invoices in this state. | |
| is_paid | No | true = only paid invoices, false = only unpaid. | |
| page_size | No | Records per page, 1-200 (default 50). | |
| contact_id | No | Only invoices of this contact (from billy_list_contacts). | |
| invoice_no | No | Exact invoice number. | |
| max_due_date | No | Due date on or before (yyyy-mm-dd); with is_paid=false this finds overdue invoices. | |
| min_due_date | No | Due date on or after (yyyy-mm-dd). | |
| sort_property | No | Sort by (default entryDate). | |
| max_entry_date | No | Invoice date on or before (yyyy-mm-dd). | |
| min_entry_date | No | Invoice date on or after (yyyy-mm-dd). | |
| sort_direction | No | Sort direction (default ASC). | |
| entry_date_period | No | Date period: all, year:2026, month:2026-03, quarter:2026-2, dates:2026-01-01...2026-01-31 ... |