# Räkenskapsår (/api/referens/financialyears)

> Räkenskapsår – lista och hämta organisationens räkenskapsår via /3/financialyears.

Resursen speglar Fortnox `/3/financialyears`. Läs den först: `Id` här är samma tal som `?financialyear=` på [konton](/api/referens/accounts), [verifikationer](/api/referens/vouchers) och [verifikationsserier](/api/referens/voucherseries), och samma tal som deras `Year`-fält. Det är ett löpnummer, **inte** ett årtal.

Resursen är skrivskyddad i Klirr. Det finns ingen `POST`: räkenskapsår skapas när bokföringen sätts upp i Klirr.

**Scope:** `bookkeeping` · <Plan min="ai_pro" />

## Endpoints [#endpoints]

| Metod och sökväg | Beskrivning |
|---|---|
| <Endpoint method="GET" path="/api/v1/3/financialyears" /> | Lista räkenskapsår |
| <Endpoint method="GET" path="/api/v1/3/financialyears/{Id}" /> | Hämta ett räkenskapsår |

Bas-URL: `https://app.klirr.ai/api/v1`.

## Listparametrar [#listparametrar]

Listan stöder [paginering](/api/paginering) (`page`, `limit`, `offset`) och är sorterad på startdatum, äldst först. Andra parametrar läses inte; Fortnox `?date=` stöds alltså inte.

## Fält [#fält]

Listform och fullständig form är identiska.

| Fält | Typ | Skrivskyddat | Beskrivning |
|---|---|---|---|
| `@url` | string | ja | Resursens URL i Klirr. |
| `Id` | number | ja | Räkenskapsårets löpnummer. |
| `FromDate` | string | ja | Första dag, `ÅÅÅÅ-MM-DD`. |
| `ToDate` | string | ja | Sista dag, `ÅÅÅÅ-MM-DD`. |
| `AccountChartType` | string | ja | Alltid `BAS 2013`. |
| `AccountingMethod` | `ACCRUAL` \| `CASH` | ja | `CASH` om organisationen använder kontantmetoden, annars `ACCRUAL`. |

## Lista räkenskapsår [#lista-räkenskapsår]

<Tabs groupId="lang" persist items={['curl','TypeScript']}>
<Tab value="curl">
```bash
curl https://app.klirr.ai/api/v1/3/financialyears \
  -H "Authorization: Bearer <access_token>"
```
</Tab>
<Tab value="TypeScript">
```ts
const res = await fetch('https://app.klirr.ai/api/v1/3/financialyears', {
  headers: { Authorization: 'Bearer <access_token>' },
});
const { FinancialYears, MetaInformation } = await res.json();
```
</Tab>
</Tabs>

```json
{
  "FinancialYears": [
    {
      "@url": "https://app.klirr.ai/api/v1/3/financialyears/3",
      "Id": 3,
      "FromDate": "2026-01-01",
      "ToDate": "2026-12-31",
      "AccountChartType": "BAS 2013",
      "AccountingMethod": "ACCRUAL"
    }
  ],
  "MetaInformation": { "@TotalResources": 1, "@TotalPages": 1, "@CurrentPage": 1 }
}
```

## Hämta ett räkenskapsår [#hämta-ett-räkenskapsår]

<Tabs groupId="lang" persist items={['curl','TypeScript']}>
<Tab value="curl">
```bash
curl https://app.klirr.ai/api/v1/3/financialyears/3 \
  -H "Authorization: Bearer <access_token>"
```
</Tab>
<Tab value="TypeScript">
```ts
const res = await fetch('https://app.klirr.ai/api/v1/3/financialyears/3', {
  headers: { Authorization: 'Bearer <access_token>' },
});
const { FinancialYear } = await res.json();
```
</Tab>
</Tabs>

Svaret kuverteras i `FinancialYear` med samma fält som i listan.

## Fel [#fel]

| Status | `Code` | När |
|---|---|---|
| 404 | 9000404 | `Kan inte hitta räkenskapsåret`. Gäller även ett `Id` som inte är ett positivt heltal, till exempel ett årtal som inte råkar vara ett giltigt löpnummer. |

Allmänna fel (401, 403, 429) beskrivs under [Felkoder](/api/felkoder).