---
title: "Get fiscal years"
method: GET
path: "/companies/{companyId}/fiscal-years"
tags: ["fiscal-years"]
---

# Get fiscal years

`GET /companies/{companyId}/fiscal-years`

## Request

- Base URL: `https://api.bokio.se/v1`
- URL: `https://api.bokio.se/v1/companies/{companyId}/fiscal-years`
- Auth: HTTP bearer

Get all fiscal years for the company. Use the query parameters to filter and navigate through the results.


**Scope:** `fiscal-years:read`

## Query parameters

- `page` integer
- `pageSize` integer
- `query` string

## Response `200`

Successful response with fiscal years

- object
  - `totalItems` integer
  - `totalPages` integer
  - `currentPage` integer
  - `items` FiscalYear[]
    - `id` string, uuid, required: Unique identifier for the fiscal year
    - `startDate` string, date, required: The start date of the fiscal year
    - `endDate` string, date, required: The end date of the fiscal year
    - `accountingMethod` 'cash' | 'accrual', required: The accounting method used by the fiscal year
    - `status` 'open' | 'closed': The status of the fiscal year

---

[API](https://skmtc.dev/bokio/apis/company-api.md) - [All operations](https://skmtc.dev/bokio/apis/company-api/llms.txt) - [OpenAPI document](https://skmtc.dev/bokio/apis/company-api/revisions/9395020f3da2?raw)
