List invoices
vyfakturuj_list_invoicesRead-only
Search documents (faktury, zalohove faktury, proformy, objednavky ...); pass sort=date_created~desc for the newest first. Each row has id, number, type, dates, customer, VS, currency, total, flags and flags_decoded (paid, sent_to_customer, cancelled, ...) and the public/PDF URLs; use vyfakturuj_get_invoice for the whole document with items. Filter by free text q, customer id, document type, number, variable symbol (VS), currency or creation date range. Paged with rows_limit/rows_offset. GET /invoice/.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Free-text search over the invoices. | |
| VS | No | Variable symbol (variabilni symbol). | |
| sort | No | Sort: column~asc or column~desc, several joined by | (for example date_created~desc|number~asc). | |
| type | No | Document type: 1 faktura, 2 zalohova faktura, 4 proforma, 8 vyzva k platbe, 16 danovy doklad, 32 opravny danovy doklad, 64 prijmovy doklad, 128 opravny doklad, 512 objednavka. | |
| number | No | Exact document number. | |
| currency | No | Currency, ISO 4217, e.g. CZK, EUR. | |
| rows_limit | No | Rows to return, 1-100 (default 25). | |
| id_customer | No | Only invoices of this address-book contact (from vyfakturuj_list_contacts). | |
| rows_offset | No | Rows to skip (default 0). Use next_offset from the previous reply. | |
| date_created_to | No | Created on or before this date (yyyy-mm-dd). | |
| date_created_from | No | Created on or after this date (yyyy-mm-dd). |