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

# List bank accounts

`GET /v1/banking/accounts`

## Request

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

Returns the connected bank accounts (bank connections) for the workspace.

## Query parameters

- `provider` string
- `isActive` boolean
- `limit` integer
- `offset` integer

## Response `200`

List of bank accounts

- object
  - `data` BankAccount[]
    - `id` string
    - `provider` string, nullable: saltedge | tink | truelayer | yodlee | revolut | manual
    - `bankName` string, nullable
    - `accountName` string, nullable
    - `accountNumber` string, nullable: Last 4 digits for display.
    - `iban` string, nullable: Masked IBAN.
    - `currency` string, nullable
    - `isActive` boolean
    - `lastSyncAt` string, date-time, nullable
    - `createdAt` string, date-time, nullable
    - `updatedAt` string, date-time, nullable
  - `total` integer
  - `limit` integer
  - `offset` integer
  - `hasMore` boolean

## Other responses

- `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)