Expenses
Supplier invoices and cost documents, with line items and payments.
List expenses
Supplier invoices and cost documents, newest entries first. Filter by date range, partner, category, or project. For whole-year spend totals prefer /reports/yearly-summary — one call instead of many pages.
query Parameters
date_fromdate_topartner_idInteger id from GET /partners.
category_idsubcategory_idproject_idReturns every expense that references this project — whether it is the expense's single project or one leg of a split across projects. For a split expense the split allocations are authoritative and the header project is ignored.
cursorThe next_cursor value from the previous response, exactly as received. Leave out for the first page.
limitPage size. Values outside 1–1000 fail with 400.
List expenses › Responses
One page of expenses.
next_cursorGet one expense
Full detail including line items and payments.
path Parameters
idAn expense id, e.g. from the list endpoint.
Get one expense › Responses
Full expense detail.
idUnique, permanent id. A random string — use it exactly as returned.
company_keyinvoice_numberreference_numberexpense_datedocument_datedue_dateposted_datenoteAn id + name pair, e.g. a category or partner. Both null when not set.
An id + name pair, e.g. a category or partner. Both null when not set.
An id + name pair, e.g. a category or partner. Both null when not set.
Projects this expense is booked to. Always an array: one entry for a
single directly-set project (its amount is null — no split
allocation is stored), multiple entries when the expense is split
across projects (each carrying its allocated gross). Empty when no
project is set.
grossTotal including VAT, in currency. Summed from line items when present, else the document total.
netTotal excluding VAT, summed from line items; null when the expense has no items.
currencygross_eurGross in EUR (2 decimals) — use for cross-currency sums.
net_eurNet in EUR (2 decimals).
exchange_rateEUR per unit of the document currency; null when not known.
percentage_paidFraction of gross settled by linked bank transactions — 0.27 means 27 % paid, values above 1 mean overpaid. Null when no payments are linked or gross is unknown.
ready_for_accounting