---
title: "List the chart of accounts"
method: GET
path: "/chart-accounts"
tags: ["Chart of Accounts"]
---

# List the chart of accounts

`GET /chart-accounts`

## Request

- Base URL: `https://api.lumabill.ch/v1`
- URL: `https://api.lumabill.ch/v1/chart-accounts`
- Auth: HTTP bearer

Returns the profile's chart of accounts (Swiss Kontenplan KMU) with account UUIDs, codes, names and types. Account UUIDs are required for bank transaction adjustments, categorization, expense lines, and expense payments.

## Query parameters

- `includeBalances` boolean
- `fiscalYearId` string, uuid

## Response `200`

List of chart accounts

- ChartAccount[]
  - `id` string, uuid, required
  - `code` string, required: Swiss chart of accounts (Kontenplan KMU) account number
  - `name` string, required
  - `type` 'ASSET' | 'LIABILITY' | 'EQUITY' | 'REVENUE' | 'EXPENSE', required
  - `parentCode` string, nullable
  - `isSystem` boolean
  - `isActive` boolean
  - `currency` 'CHF' | 'EUR' | 'USD' | 'GBP' | 'JPY' | 'CAD' | 'AUD' | 'SEK' | 'NOK' | 'DKK' | 'HUF': ISO 4217 code of a currency the API converts (ESTV/BAZG rates). The same list applies to every currency field of the API.
  - `createdAt` string, date-time
  - `balance` number, double, nullable: Only present when includeBalances=true (CHF)
  - `fwBalance` number, double, nullable: FW accounts with includeBalances=true only: the saldo in the account currency, over the requested fiscalYearId, else as of today over the fiscal year covering today (null when no year covers today).
  - `carryForwardMissing` boolean: FW accounts with includeBalances=true only: true when the previous fiscal year is still open, so the year holds no Saldovortrag and `balance` / `fwBalance` show only this year's movements.

## Other responses

- `401`: Invalid or missing API key
- `403`: Subscription required or read-only key on a write endpoint
- `429`: Rate limit exceeded
- `500`: Internal server error

---

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