---
title: "List fiscal years"
method: GET
path: "/fiscal-years"
tags: ["Fiscal Years"]
---

# List fiscal years

`GET /fiscal-years`

## Request

- Base URL: `https://api.lumabill.ch/v1`
- URL: `https://api.lumabill.ch/v1/fiscal-years`
- Auth: HTTP bearer

## Response `200`

The profile's fiscal years, newest first

- FiscalYear[]
  - `id` string, uuid
  - `year` integer
  - `startDate` string, date
  - `endDate` string, date
  - `status` 'OPEN' | 'CLOSED'
  - `closedAt` string, date-time, nullable
  - `createdAt` string, date-time
  - `exportStatus` string, nullable
  - `exportRequestedAt` string, date-time, nullable

## Other responses

- `401`: Invalid or missing API key
- `403`: Subscription required or read-only key on a write endpoint
- `404`: Resource not found
- `429`: Rate limit exceeded
- `500`: Internal server error

---

[API](https://skmtc.dev/lumabill/apis/lumabill-api.md) · [All operations](https://skmtc.dev/lumabill/apis/lumabill-api/llms.txt) · [OpenAPI document](https://skmtc.dev/lumabill/apis/lumabill-api/revisions/e48e7099b545?raw)