List transactions

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-Range and X-Total-Count
    headers describe the window.
  • Sorting: _field / _order. Sortable virtual fields include cartola_date (the
    default), merchant_name, card_name, card_last4, amount, target_amount,
    cumulative_balance and created_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=true to inject running balances
    (target_cumulative_balance_with_commission). This requires a resolvable company.
  • Hide commissions: pass _hide_commissions=true to 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.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Query Params
integer
≥ 0

If all the transactions where in an array, this would represent the index of the first item returned in the response

integer
≥ 0

If all the transactions where in an array, this would represent the index of the last item returned in the response

string
enum

The order method, which can be ascending or descending

Allowed:
string

The field used to sort, the example illustrates a response that would be sorted by the creation date

string
enum

When true, injects running balances. Requires a resolvable company.

Allowed:
string
enum

When true, omits commission rows from the list.

Allowed:
string

Filter by transaction type (plain value or JSON operator).

string

Filter by status (plain value or JSON operator).

uuid

Filter by the cartola a transaction is assigned to.

string

Filter by accounting date (JSON operators supported).

Headers
uuid
required

UUID of the company on whose behalf the request is made. Required for every Accounting endpoint.
See The company-id header for details on how to obtain
a value for this header and the error responses to expect when it is missing or invalid.

Responses

401

Unauthorized — missing/invalid Authorization. The body is empty for the shared auth
guard; branch on the status code, not the body.

Language
Credentials
Bearer
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json