200Successful Response
Schema: SuccessEnvelope_BillsListResponse_
successbooleanmessagestringcodestringdataBillsListResponse
/api/v1/billsRetrieve all bills for a business with cursor-based pagination. Can filter by vendor name (fuzzy search) or associated journal entry.
Bearer token authentication. Pass your DayZero API token in the Authorization header and the target business UUID in x-business-id.
vendor_searchstringFuzzy search bills by vendor name (uses PostgreSQL trigram matching)
journal_entry_idstringFilter bills by associated journal entry UUID
payment_methodstringFilter bills by payment method: 'Wire Transfer', 'ACH', 'Check', 'Credit Card'
vendor_idstringFilter bills by vendor UUID
statusstringFilter by bill status (e.g. draft, approved, received, paid, canceled)
searchstringSearch bills by bill number, description, or vendor name (case-insensitive partial match)
bill_numberstringFilter bills by invoice/bill number (case-insensitive partial match)
due_date_fromstringFilter bills with due date on or after this date (YYYY-MM-DD)
due_date_tostringFilter bills with due date on or before this date (YYYY-MM-DD)
cursorstringCursor for pagination
limitintegerPagination limit
directionstringdefault: nextPagination direction: 'next' or 'prev'
include_total_countbooleandefault: FalseWhether to include total count (expensive - avoid if possible)
sort_bystringColumn name to sort by (e.g. 'created_at', 'amount', 'name'). When changing sort, reset cursor to None.
descendingbooleandefault: TrueSort direction: true for descending (newest/largest first), false for ascending
Schema: SuccessEnvelope_BillsListResponse_
successbooleanmessagestringcodestringdataBillsListResponseSchema: HTTPValidationError
detailarray · ValidationErrorValidationErrorlocarray · string | integerrequiredmsgstringrequiredtypestringrequiredinputobjectctxobject