---
title: "List the account-displaying picker rows for the authenticated company."
method: GET
path: "/core/latest/accounting/accounts/account-displaying"
tags: ["Accounting"]
deprecated: true
---

# List the account-displaying picker rows for the authenticated company.

`GET /core/latest/accounting/accounts/account-displaying`

## Request

- Base URL: `https://api.klara.ch`
- URL: `https://api.klara.ch/core/latest/accounting/accounts/account-displaying`
- Auth: one of:
  - API key in header `X-API-KEY`
  - HTTP bearer

> **Deprecated.**

This operation remains available until <b>2027-08-14</b> and is removed after that date. Use <code>GET /core/v1/accounting/accounts/account-displaying</code> instead.<br/><br/>Returns a flat list of <code>AccountDisplaying</code> rows for every account in the caller's company chart of accounts. Each row represents one selectable combination that a bookkeeper can pick when entering a manual journal line. Tenant and company are derived from the bearer token — there are no tenant or company path parameters.<p><strong>How rows are produced:</strong> For each master account the downstream service checks whether the account carries any linked sub-account definitions (e.g. a bank account linked to specific bank-accounts, a VAT account linked to VAT-rate items). If the account has <em>no</em> sub-account definitions, exactly one bare row is emitted with <code>combinedCode</code> equal to the bare account code (e.g. <code>"3000"</code>), <code>linkType</code> equal to <code>null</code>, and <code>specificationItem</code> equal to <code>null</code>. If the account has one or more sub-account link specifications, one row is emitted per individual sub-account entry, numbered sequentially across <em>all</em> link types with a 0-based counter suffix: <code>"1020-0"</code>, <code>"1020-1"</code>, …</p><p><strong>combinedCode:</strong> <code>"&lt;accountCode&gt;-&lt;i&gt;"</code> when a sub-account exists (e.g. <code>"1020-0"</code>), or the bare account code string (e.g. <code>"3000"</code>) when <code>linkType</code> is <code>null</code>. The suffix index is a flat 0-based counter per account, spanning all link types in declaration order.</p><p><strong>combinedName:</strong> <code>"&lt;accountName&gt; (&lt;subAccountDisplay&gt;)"</code> when a sub-account exists (e.g. <code>"Bank (UBS)"</code>), or the bare account name (e.g. <code>"Bürobedarf"</code>) when <code>linkType</code> is <code>null</code>.</p><p><strong>parentAccount:</strong> the full master account this row belongs to. Always populated, including for bare rows.</p><p><strong>linkType:</strong> the link-type category name (e.g. <code>"BANK"</code>, <code>"CUSTOMER"</code>, <code>"VAT_RATE"</code>). <code>null</code> when the account has no sub-account definitions.</p><p><strong>linkDisplay:</strong> the human-readable label for the link type in the current locale (e.g. <code>"Bank account"</code>). Falls back to the German label when no translation exists for the requested language. <code>null</code> when <code>linkType</code> is <code>null</code>.</p><p><strong>linkOptional:</strong> <code>true</code> when the sub-account selection is optional for the user (link keys are separated by <code>;</code> in the account definition); <code>false</code> when selecting a sub-account is mandatory (link keys separated by <code>,</code>); <code>null</code> when the account has no sub-account definitions.</p><p><strong>specificationItem:</strong> the resolved sub-account entry for this row. Its <code>link</code> field is the URI that must be round-tripped back to the booking endpoint when the user selects this row. Its <code>display</code> field is the human-readable label shown to the bookkeeper (e.g. <code>"UBS"</code>, <code>"8.1 %"</code>). <code>null</code> when <code>linkType</code> is <code>null</code>.</p><p>Row order is stable: accounts are sorted by code ascending (same order as <code>GET /core/latest/accounting/accounts</code>); sub-account rows within each account preserve the link-type declaration order and then the entry order returned by the underlying service.</p>The endpoint is a pure read — idempotent, no side effects. The caller must hold the <code>ACCOUNTING</code> permission on the company in scope.

## Query parameters

- `legal-form` 'LIMITED_LIABILITY' | 'CORPORATION' | 'OR' | 'INDIVIDUALLY_OWNED_COMPANY' | 'ASSOCIATION' | 'SIMPLE_PARTNERSHIP' | 'GENERAL_PARTNERSHIP' | 'LIMITED_PARTNERSHIP' | 'COOPERATIVE_COMPANY' | 'FOUNDATION'

## Headers

- `Accept-Language` string

## Response `200`

Flat list of account-displaying rows, sorted by account code ascending. Each row contains <code>combinedCode</code>, <code>combinedName</code>, <code>parentAccount</code>, and the link fields populated for sub-account rows or <code>null</code> for bare rows. Returns an empty array when no accounts match the supplied <code>legal-form</code>.

- PublicApiAccountDisplaying[]
  - `combinedCode` string: Picker key. <code>"&lt;accountCode&gt;-&lt;i&gt;"</code> when a sub-account exists (e.g. <code>"1020-0"</code>); the bare account code string (e.g. <code>"3000"</code>) when <code>linkType</code> is <code>null</code>. The suffix index is a flat 0-based counter per account, spanning all link types in declaration order.
  - `combinedName` string: Picker label. <code>"&lt;accountName&gt; (&lt;subAccountDisplay&gt;)"</code> when a sub-account exists (e.g. <code>"Bank (UBS)"</code>); the bare account name (e.g. <code>"Bürobedarf"</code>) when <code>linkType</code> is <code>null</code>.
  - `parentAccount` object: The full master account this row belongs to. Identical across every row produced for the same account.
    - `id` integer: Internal identifier of the master account.
    - `code` integer: Numeric account code as printed on the chart of accounts.
    - `name` string: Localized account name. Resolved against the request's <code>Accept-Language</code> and, when <code>legal-form</code> is supplied, against the legal-form-specific translation.
    - `tags` string: Free-text keyword tokens associated with the account, used by client-side search. Tokens are delimited by comma or semicolon.
    - `links` string: Linked-account references used by report computations.
    - `accountReportLinks` string: Report-grouping references used to assemble balance-sheet / P&L groupings.
    - `initialBalanceSheet` boolean: True when the account is part of the initial opening-balance sheet.
    - `visibleFirstFiscalYear` boolean: True when the account is visible during the first fiscal year of a new company.
    - `visibleFromSecondFiscalYear` boolean: True when the account becomes visible from the second fiscal year onwards.
    - `vatAccount` boolean: True when the account is reserved for VAT postings.
    - `accountReportFilters` PublicApiAccountReportFilter[]: Report-grouping configuration rows attached to this account.
      - `display` string: Human-readable label of the report bucket this account contributes to.
      - `linkAccountValue` string: Underlying linked-account value used by the accounting engine to resolve the bucket.
    - `notManuallyAdded` boolean: True when the account was seeded automatically (not added by an end user).
  - `linkType` string: Link-type category. Identifies the kind of entity the sub-account refers to. Common values: <code>VAT_RATE</code>, <code>VAT_CASE</code>, <code>BANK</code>, <code>CUSTOMER</code>, <code>SUPPLIER</code>, <code>EMPLOYEE</code>, <code>SOCIAL_INSURANCE</code>, <code>TAX_AT_SOURCE</code>, <code>EQUITY</code>, <code>TANGIBLE_ASSET</code>, <code>IMMOBILE_TANGIBLE_ASSET</code>, <code>UNFINISHED_PRODUCTS</code>, <code>FINISHED_PRODUCTS</code>, <code>NON_BILLED_SERVICES</code>, <code>INVENTORY_CHANGE_MATERIAL</code>, <code>INVENTORY_CHANGE_GOODS</code>, <code>LONG_TERM_INTEREST_BEARING</code>, <code>OTHER_LONG_TERM_INTEREST_BEARING</code>, <code>GIFT_CARD</code>, <code>VARIOUS</code>. <code>null</code> when the account has no sub-account definitions.
  - `linkDisplay` string: Human-readable label for the link type in the requested <code>Accept-Language</code>. Falls back to the German label when no translation exists for the requested language. <code>null</code> when <code>linkType</code> is <code>null</code>.
  - `linkOptional` boolean: <code>true</code> when the sub-account selection is optional for the user (link keys are separated by <code>;</code> in the account definition); <code>false</code> when selecting a sub-account is mandatory (link keys separated by <code>,</code>); <code>null</code> when the account has no sub-account definitions.
  - `specificationItem` object: The resolved sub-account entry for this row. <code>null</code> when the account has no sub-account definitions.
    - `id` string: Stable identifier of the underlying entity (e.g. bank-account id, VAT-rate id, customer id). May be <code>null</code> for synthesized entries.
    - `filteredBy` string: Optional filter token used by the Accounting UI to narrow the picker. Empty for most link types.
    - `display` string: Human-readable label shown in the picker (e.g. <code>"UBS"</code> for a bank account, <code>"8.1 %"</code> for a VAT rate).
    - `link` string: Canonical URI for this sub-account choice. MUST be round-tripped verbatim to the booking-creation endpoint when the row is selected.
    - `additionalAttribute` string: Free-form additional attribute attached by the link-type supplier. Most types leave this empty.
    - `snippetReference` string: Optional snippet reference returned by the underlying entity (used by some link types to carry a template hint).
    - `value` string: Optional raw value associated with the entry (e.g. the VAT percentage as a decimal string).
    - `validFrom` string, date: Inclusive start of the validity window of the underlying entity (ISO <code>yyyy-MM-dd</code>). <code>null</code> when not applicable.
    - `validTo` string, date: Inclusive end of the validity window of the underlying entity (ISO <code>yyyy-MM-dd</code>). <code>null</code> when open-ended.

## Other responses

- `401`: No Authorization header found or invalid token<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `403`: The current user is not allowed to access this company data<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `404`: The company associated with the caller's session could not be resolved by the downstream accounting service, or the supplied <code>legal-form</code> value does not match any known legal form.<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `410`: Gone. This operation is removed after 2027-08-14; every call after that date answers 410. Use <code>GET /core/v1/accounting/accounts/account-displaying</code> instead.<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `429`: API rate limit exceeded<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.
- `500`: Something went wrong on our side while processing the request. Please kindly contact our support.<br/><br/>Failures detected by a downstream service carry that service's own <code>code</code>, which this reference does not enumerate, so the <code>code</code> field may hold a value not documented here. Treat an unrecognised code as a generic failure of the status it arrives with, and do not branch on a code this reference does not list.

---

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