---
title: "Get Bookyears"
method: GET
path: "/consumers/{consumer_id}/accounting/bookyears"
tags: ["Accounting", "Book years"]
---

# Get Bookyears

`GET /consumers/{consumer_id}/accounting/bookyears`

## Path parameters

- `consumer_id` string, uuid, required

## Query parameters

- `page` integer
- `size` integer
- `folder_id` string, nullable

## Response `200`

Successful Response

- ChiftPageBookYear
  - `items` BookYear[], required
    - `name` string, required — Name of the book year, typically in the format 'YYYY'.
    - `start` string, date, required — Start date of the book year (format: YYYY-MM-DD). This is the date when the book year begins.
    - `end` string, date, required — End date of the book year (format: YYYY-MM-DD). This is the date when the book year ends.
    - `closed` boolean, required — Indicates whether the book year is closed. A closed book year normally cannot be modified or have new entries added to it.
  - `total` integer, required
  - `page` integer, required
  - `size` integer, required

## Other responses

- `400` — Bad Request
- `422` — Validation Error

---

[API](https://skmtc.net/chift/apis/chift-api.md) · [All operations](https://skmtc.net/chift/apis/chift-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/chift/chift-api/versions/b5f1214a482a/schema)