List transactions
const url = 'https://example.com/api/v1/money/budgets/example/transactions';const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
try { const response = await fetch(url, options); const data = await response.json(); console.log(data);} catch (error) { console.error(error);}curl --request GET \ --url https://example.com/api/v1/money/budgets/example/transactions \ --header 'Authorization: Bearer <token>'Return register rows from a budget, newest first. Use account_id to filter rows by account, or month to filter rows by month. The response includes the budget currency and scale. Route: /api/v1/money/budgets/{budget_id}/transactions. Inputs: budget_id, account_id, month. Safe reads can use bounded retries.
Authorizations
Section titled “Authorizations”Parameters
Section titled “Parameters”Path Parameters
Section titled “Path Parameters”Budget ID
Query Parameters
Section titled “Query Parameters”Only rows of this account (both legs of transfers).
Only rows dated in this month YYYY-MM.
Responses
Section titled “Responses”Register rows, newest first
Register rows, newest first.
object
Budget ID.
Budget currency.
Decimal places of the budget currency.
Rows sorted by date, newest first; same-date rows in reverse file order.
One register row.
object
Account whose register shows this row.
Account name.
Amount in currency minor units, as seen by account_id.
Amount in budget minor units.
Category ID (a Split or Transfer marker for those rows).
Category name.
This Account’s cleared mark; explicit source state overrides legacy
#cleared tags and remains independent of reconciled state (#1130).
Currency of amount.
Date YYYY-MM-DD.
True when this build can edit the row (simple, unreconciled rows only; #462, #1130).
Transaction ID (the row’s ^block-id).
simple, split, transfer or card_payment.
Payee text without tag tokens, for display next to tags.
Separate notes, with original whitespace (#1130).
Payee text exactly as written (with its tags); Notes are separate (#1130).
True when this source row was reconciled (#1130).
Decimal places of currency.
Original source rows, retained without extra postings (#1130).
Typed source evidence for split, transfer and Tracking rows (#1130). The API crate owns its schema; the pure Money crate has no HTTP dependency. Evidence records never create additional postings.
object
Stable Money Account identity.
Original amount in budget minor units.
Stable Money Category identity, when the source had one.
Independent source cleared mark.
Original date in YYYY-MM-DD form.
Original export identity.
Original Notes, including whitespace.
Original Payee, flattened for a Markdown row.
Independent source reconciled mark.
Split legs.
One split leg of a transaction.
object
Amount in budget minor units.
Category ID.
Category name.
Inline calternal tags in the Payee, in order, without #cleared (the
cleared flag has its own column). Parsed by the Notes tag grammar so a
Money tag is the same tag everywhere (DESIGN §48: ordinary tags).
The other Account of a transfer or Card payment.
Category posted by a transfer between on-budget and off-budget accounts.
Display name for transfer_category_id.
Examplegenerated
{ "budget_id": "example", "currency": "example", "scale": 1, "transactions": [ { "account_id": "example", "account_name": "example", "amount": 1, "budget_amount": 1, "category_id": "example", "category_name": "example", "cleared": true, "currency": "example", "date": "example", "editable": true, "id": "example", "kind": "example", "memo": "example", "notes": "example", "payee": "example", "reconciled": true, "scale": 1, "source_rows": [ { "account_id": "example", "amount": 1, "category_id": "example", "cleared": true, "date": "example", "id": "example", "notes": "example", "payee": "example", "reconciled": true } ], "splits": [ { "amount": 1, "category_id": "example", "category_name": "example" } ], "tags": [ "example" ], "transfer_account_id": "example", "transfer_category_id": "example", "transfer_category_name": "example" } ]}The standard API error response: { "error": { ... } }.
object
Example
{ "error": { "code": "bad_request" }}The standard API error response: { "error": { ... } }.
object
Example
{ "error": { "code": "bad_request" }}The standard API error response: { "error": { ... } }.
object
Example
{ "error": { "code": "bad_request" }}