list_bills
Read-only
Filter and list supplier bills in Billy by supplier, state, paid status, date range, or free-text search.
Instructions
List supplier bills (expenses) in Billy with filters for supplier, state, paid status, date range and free-text search.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free-text search (contact name, description, voucher no, amount) | |
| page | No | Page number (1-based) | |
| state | No | Filter by bill state | |
| isPaid | No | Filter by paid status | |
| verbose | No | Return the full Billy response. Default false: compact records with key fields only (saves ~90% context) | |
| pageSize | No | Records per page (max 1000, default 50) | |
| contactId | No | Filter by supplier contact ID | |
| maxDueDate | No | Due date <= this (YYYY-MM-DD) | |
| minDueDate | No | Due date >= this (YYYY-MM-DD) | |
| maxEntryDate | No | Bill date <= this (YYYY-MM-DD) | |
| minEntryDate | No | Bill date >= this (YYYY-MM-DD) | |
| sortProperty | No | Sort field: entryDate, dueDate, createdTime, amount, balance, contact.name, voucherNo | |
| sortDirection | No | Sort direction | |
| suppliersInvoiceNo | No | Filter by the supplier's invoice number |