Pass accountId (manual account id or bank/crypto snapshot id). Optional source (manual/bank/crypto) when the id could be ambiguous. Prefer narrow date windows; avoid dumping full history.
GET
/v1/list_transactionsQuery
| Field | Type | Required | Default | Description |
|---|---|---|---|---|
| budgetId | string | Yes | — | Budget that owns the account. |
| accountId | string | Yes | — | Manual account id, or bank/crypto snapshot id from connections / list_accounts. |
| source | string | No | — | Optional: manual, bank, or crypto when disambiguating accountId. |
| pageToken | string | No | — | Cursor from a previous nextPageToken. |
| limit | number | No | 30 | Page size (1–100). |
Response shape: { items, nextPageToken?, hasMore }.
Response data
| Field | Type | Description |
|---|---|---|
| items | array | Transactions. |
| hasMore | boolean | True when more pages are available. |
| nextPageToken | string | Cursor for the next page; null when hasMore is false. |
Item fields
| Field | Type | Description |
|---|---|---|
| id | string | Id of the transaction. |
| source | string | manual, bank, or crypto. |
| accountId | string | Account id (manual or snapshot). |
| budgetId | string | Owning budget id when present (manual). |
| amount | number | Amount in the relevant currency units (signed). |
| currency | string | ISO 4217 currency code. |
| description | string | Free-text description or memo. |
| merchant | string | Counterparty / merchant when present and distinct from description. |
| postedAt | string | ISO-8601 posted timestamp. |
| category | string | Category label when present on synced transactions. |
| originalAmount | number | Original amount before FX when present (synced). |
| originalCurrency | string | Original currency before FX when present (synced). |
| txHash | string | On-chain hash / signature when present (crypto). |
| network | string | Crypto network when present. |
| tokenSymbol | string | Token symbol when present (crypto). |
| direction | string | in or out when present (crypto). |
| isDeleted | boolean | Soft-delete flag when present (manual). |
| deletedAt | string | ISO-8601 soft-delete timestamp when present. |
| createdAt | string | Creation timestamp when present. |
| updatedAt | string | Last update timestamp when present. |