---
title: "List Gl Periods"
method: GET
path: "/companies/{company_id}/gl/periods"
tags: ["gl"]
---

# List Gl Periods

`GET /companies/{company_id}/gl/periods`

## Request

- Base URL: `https://app.zeno-works.ch` (the document declares no server; this is the origin it was published from)
- URL: `https://app.zeno-works.ch/companies/{company_id}/gl/periods`
- Auth: none declared

The company's **accounting periods** — the months a journal entry may post into
(CompanyMember read).

A period belongs to one fiscal year and carries ``period_no`` (1..12 within the
year), ``date_from``/``date_to`` and a ``status``: ``open`` accepts postings,
``soft_closed`` still accepts them, and ``closed``/``year_closed`` refuse them — a
posting date inside a closed period fails until an accountant explicitly reopens
the period (``POST …/gl/periods/{period_id}/reopen``, reason required, recorded in
the close-run ledger — ZET-161).
``fiscal_year_id`` narrows to one year; omitted, every year's periods come back.

This is **not** the VAT filing calendar — those are the ``gl_vat_period`` rows of
``GET …/gl/vat/periods``, which have their own quarterly/monthly cadence and their
own ``filed``/``paid`` sealing. Use this list to find the ``period_id`` a manual
journal entry needs, and to check *why* a posting date was refused.

## Path parameters

- `company_id` string, required

## Query parameters

- `fiscal_year_id` string, nullable

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Response `200`

Successful Response

- GlFiscalPeriodsResponse
  - `periods` GlFiscalPeriodOut[], required
    - `id` string, required
    - `company_id` string, required
    - `fiscal_year_id` string, required
    - `period_no` integer, required
    - `date_from` string, date, required
    - `date_to` string, date, required
    - `status` string, required

## Other responses

- `422`: Validation Error

---

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