---
title: "List bank transactions"
method: GET
path: "/v1/banking/transactions"
tags: ["Banking"]
---

# List bank transactions

`GET /v1/banking/transactions`

## Request

- Base URL: `https://api.frihet.io`
- URL: `https://api.frihet.io/v1/banking/transactions`
- Auth: API key in header `X-API-Key`

Returns bank transactions for the workspace. Filter by account, date range, status, or category.

## Query parameters

- `accountId` string
- `from` string, date
- `to` string, date
- `status` 'raw' | 'recognized' | 'matched' | 'categorized' | 'excluded'
- `category` string
- `reconciled` boolean
- `limit` integer
- `offset` integer

## Response `200`

List of bank transactions

- object
  - `data` BankTransaction[]
    - `id` string
    - `connectionId` string: ID of the owning bank account (accountId).
    - `transactionId` string: Provider transaction ID (manual-* for API-created entries).
    - `date` string, date
    - `amount` number: Positive for income, negative for expenses.
    - `currency` string
    - `description` string
    - `reference` string, nullable
    - `category` string, nullable
    - `counterparty` object, nullable
      - `name` string
      - `accountNumber` string
      - `iban` string
    - `reconciled` boolean
    - `reconciledWith` 'invoice' | 'expense', nullable
    - `reconciledId` string, nullable
    - `reconciledAt` string, date-time, nullable
    - `status` 'raw' | 'recognized' | 'matched' | 'categorized' | 'excluded'
    - `source` string, nullable
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable
  - `total` integer
  - `limit` integer
  - `offset` integer
  - `hasMore` boolean

## Other responses

- `400`: Bad request - invalid parameters or request body
- `401`: Authentication required or invalid API key
- `429`: Rate limit exceeded (100 requests per minute)
- `500`: Internal server error

---

[API](https://skmtc.dev/frihet/apis/frihet-api.md) · [All operations](https://skmtc.dev/frihet/apis/frihet-api/llms.txt) · [OpenAPI document](https://skmtc.dev/frihet/apis/frihet-api/revisions/3dd37f6a72d1?raw)