# transactions.list

Search imported bank and card transactions with search text, accountId, currency, from/to dates, allocation (matched, unmatched or partial), direction (in or out), minAmount/maxAmount in minor units, limit and offset. Each line includes allocatedMinor and the entry ids it is matched to.

`GET | POST /api/v1/accounting/transactions.list`

Permissions: `accounting:read` · Roles: admin, finance

MCP tool: `accounting_list_transactions`

## Fields

| Field | Type | Required | Notes |
| --- | --- | --- | --- |
| `includeReversed` | boolean |  | Also include reversed. |
| `currency` | string |  | Three-letter currency code, such as CAD or USD. |
| `search` | string |  | Text to search for. at most 200 characters. |
| `accountId` | string (ID) |  | The ID of a bank, card or payment account, from accounts.list. |
| `from` | string |  | The first date to include, as YYYY-MM-DD. |
| `to` | string |  | The last date to include, as YYYY-MM-DD. |
| `allocation` | enum |  | One of: `matched`, `unmatched`, `partial`. |
| `direction` | enum |  | One of: `in`, `out`. |
| `minAmount` | string |  | The smallest amount to include, in cents, written as a string. Whole number written as a string. |
| `maxAmount` | string |  | The largest amount to include, in cents, written as a string. Whole number written as a string. |
| `tagId` | string (ID) |  | The ID of a project tag, from tags.list. |
| `untagged` | boolean |  |  |
| `limit` | integer |  | How many results to return at most. 1 to 500. Default `100`. |
| `offset` | integer |  | How many results to skip, for the next page of a list. 0 to 100000. Default `0`. |

## Example request

```bash
curl https://app.getoatmilk.com/api/v1/accounting/transactions.list \
  -H "Authorization: Bearer $OATMILK_API_KEY"
```

Reference page: https://app.getoatmilk.com/docs/api/transactions.list