list_items
List/filter items, scoped to the caller's member companies (A1).
Optional period (YYYY-MM) filters by the item's effective date
(invoice date, falling back to the Europe/Zurich-local ingestion date); a
malformed value returns 422 {"msg": "period must be YYYY-MM"}.
exclude_triage_status drops items carrying that triage verdict (NULL-safe;
for unrelated not a booked one, ZCT-954). Payables/Receivables pass
unrelated, so parked items show only in the Inbox.
Optional q is free text: a case-insensitive partial (substring) match
over the filename and the counterparty name from both of its sources (the
linked counterparty and the extracted data.company). %/_ are
matched literally, blank is ignored, and total counts the filtered set.
duplicate filters on the row's is_duplicate flag (ZET-413); credit_note on
its is_credit_note flag (ZET-429) — both server-side, so total stays exact.
posted filters on the posting badge (ZCT-811): true = posted, false = held,
reversed or not booked; a copy filed with the booking of the same invoice ("Already
booked", posting.filed_with) is in neither (ZEN-1).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | ||
| paid | No | ||
| limit | No | ||
| offset | No | ||
| period | No | ||
| posted | No | ||
| source | No | ||
| direction | No | ||
| duplicate | No | ||
| company_id | No | ||
| credit_note | No | ||
| triage_status | No | ||
| archive_status | No | ||
| counterparty_id | No | ||
| exclude_triage_status | No |