---
title: "List active financial-year periods of the authenticated company."
method: GET
path: "/core/latest/accounting/companies/current/financial-years"
tags: ["Accounting"]
deprecated: true
---

# List active financial-year periods of the authenticated company.

`GET /core/latest/accounting/companies/current/financial-years`

## Request

- Base URL: `https://api.klara.ch`
- URL: `https://api.klara.ch/core/latest/accounting/companies/current/financial-years`
- 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/companies/current/financial-years</code> instead.<br/><br/>Returns the company's currently active fiscal-year periods (status <code>OPEN</code> or <code>CLOSING</code>), one entry per legal-form / VAT-regime combination valid in the period. When every period shares the same <code>legalForm</code> and VAT regime the downstream service collapses them into a single aggregated period with <code>periodFrom</code> set to the earliest start date and <code>periodTo</code> set to the latest end date; otherwise the individual periods are returned. The <code>businessCaseTemplates</code> field is intentionally left empty on this endpoint — use <code>GET /core/latest/accounting/companies/current/business-case-templates</code> to retrieve the templates valid per period. Tenant and company are derived from the bearer token — there are no path or query parameters to override them. The endpoint is a pure read — idempotent, no side effects. The caller must hold the <code>ACCOUNTING</code> permission on the company in scope.

## Headers

- `Accept-Language` string

## Response `200`

Active financial-year periods of the caller's company. May be an empty array when the company has no open fiscal year yet.

- PublicApiBusinessCasePeriod[]
  - `companyId` integer: Internal id of the company this period belongs to.
  - `periodFrom` string, date: Inclusive start date of the financial year (ISO yyyy-MM-dd).
  - `periodTo` string, date: Inclusive end date of the financial year (ISO yyyy-MM-dd).
  - `legalForm` string: Legal form of the company during this period. Allowed values include EINZEL, GMBH, AG, KOLLEKTIV, KOMMANDIT, GENOSSENSCHAFT, VEREIN, STIFTUNG.
  - `companyVat` object: VAT regime active during this period.
    - `id` integer: Internal id of the company VAT row.
    - `reportingVat` string: Reporting method used to declare VAT. Allowed values: EFFECTIVE, NET_TAX_RATE, FLAT_TAX_RATE.
    - `billing` string: Billing method used to determine VAT liability. Allowed values: AGREED, RECEIVED.
    - `code` string: Composite VAT code combining reporting method and billing, or NON_VAT when the company is not VAT-liable.
    - `hasVat` boolean: True when the company is VAT-liable in this period.
    - `validFrom` string, date: Inclusive start date of the VAT regime (ISO yyyy-MM-dd).
    - `validTo` string, date: Inclusive end date of the VAT regime (ISO yyyy-MM-dd).
    - `yearlySettlement` boolean: True for yearly VAT settlement, false for quarterly/semi-annual.
  - `status` string: Status of the fiscal year. Allowed values: OPEN, CLOSING, CLOSED.
  - `businessCaseTemplates` PublicApiBusinessCaseTemplate[]: Business-case templates valid for the company's legal form and VAT regime within this period, sorted by code.
    - `id` integer: Internal id of the template in the Klara catalogue.
    - `code` string: Stable catalogue code of the template.
    - `display` string: Label of the template, already translated for the request's Accept-Language.
    - `i18n` object: All translations of the label, keyed by IETF language tag.
    - `keywordI18ns` object: All translations of the search keywords, keyed by IETF language tag.
    - `group` string: Catalogue group the template belongs to.

## 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.<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/companies/current/financial-years</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)