Returns a paginated list of accounting-ledger transactions for the company. Each row is a
unified projection of a card transaction, bank transfer, payment, commission, invoice or
balance correction, and carries its rendición (expense-tracking) custom-column values.
Key features
- Pagination:
_start/_end(default 25 items).Content-RangeandX-Total-Count
headers describe the window. - Sorting:
_field/_order. Sortable virtual fields includecartola_date(the
default),merchant_name,card_name,card_last4,amount,target_amount,
cumulative_balanceandcreated_at. - Filtering: any column can be filtered with a plain value or a JSON operator string
(e.g.{"$gte": ...},{"$in": [...]},{"$like": "%...%"}). - Cumulative balances: pass
_with_cumulative_balances=trueto inject running balances
(target_cumulative_balance_with_commission). This requires a resolvable company. - Hide commissions: pass
_hide_commissions=trueto omit commission rows.
Amount encoding
Most monetary fields are serialized as strings of integer cents. exchange_rate is a
human-formatted string; use exchange_rate_value for a machine-parseable rate.
Authorization
Non-admin callers see only transactions of companies where they hold the transactions_view
permission, plus their own transactions. Scoping is per-user across the caller's permitted
companies (via policy scope); the company-id header is not used to scope this list and
an absent/mismatched header does not by itself produce a 401.
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
401Unauthorized — missing/invalid Authorization. The body is empty for the shared auth
guard; branch on the status code, not the body.
