Accounting

List active financial-year periods of the authenticated company.

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/v1/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.

get/core/v1/accounting/companies/current/financial-years

Request

  • Base URL: https://api.klara.ch
  • URL: https://api.klara.ch/core/v1/accounting/companies/current/financial-years
  • Auth: one of:
    • API key in header X-API-KEY
    • HTTP bearer

Headers

Accept-Languagestring
Example:de-CH

IETF language tag forwarded to the downstream accounting service. Examples: <code>de-CH</code>, <code>fr-CH</code>, <code>it-CH</code>, <code>en</code>.

Response

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

companyIdinteger

Internal id of the company this period belongs to.

periodFromstring date

Inclusive start date of the financial year (ISO yyyy-MM-dd).

periodTostring date

Inclusive end date of the financial year (ISO yyyy-MM-dd).

legalFormstring

Legal form of the company during this period. Allowed values include EINZEL, GMBH, AG, KOLLEKTIV, KOMMANDIT, GENOSSENSCHAFT, VEREIN, STIFTUNG.

statusstring

Status of the fiscal year. Allowed values: OPEN, CLOSING, CLOSED.

Example response

[
  {
    "companyId": 1,
    "periodFrom": "2024-01-01",
    "periodTo": "2024-12-31",
    "legalForm": "EINZEL",
    "companyVat": {
      "id": 42,
      "reportingVat": "EFFECTIVE",
      "billing": "AGREED",
      "code": "EFFECTIVE_AGREED",
      "hasVat": true,
      "validFrom": "2024-01-01",
      "validTo": "2024-12-31"
    },
    "status": "OPEN",
    "businessCaseTemplates": [
      {
        "id": 101,
        "code": "OFFICE_SUPPLIES",
        "display": "Bürobedarf",
        "i18n": {
          "de": "Bürobedarf",
          "fr": "Fournitures de bureau"
        },
        "keywordI18ns": {
          "de": "Büro Material",
          "fr": "Fournitures"
        },
        "group": "Operating expenses"
      }
    ]
  }
]

Changes

No recorded changes to this operation across all 1 revision of this API.