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)
— the Payables/Receivables pages pass unrelated so relevance-parked items
show only in the Inbox (pipeline §"Relevance gate").
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.
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 |