---
title: "List Gl Journal Entries"
method: GET
path: "/companies/{company_id}/gl/journal-entries"
tags: ["gl"]
---

# List Gl Journal Entries

`GET /companies/{company_id}/gl/journal-entries`

## 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/journal-entries`
- Auth: none declared

List journal entries.

``period_ids`` narrows to specific fiscal periods, and is how a caller asks for
**one fiscal year** — the year's period ids (ZET-285). Without it this route
listed, and counted, every fiscal year the company has: the Journal page cut the
year out of the fetched page *client-side* while ``total`` stayed company-wide,
so a year whose entries sat past the first page rendered as "no entries match"
with no way to reach them. The service applies the filter before the count, so
``total`` is the filtered total and the pager is the year's.

``untagged_subledger_control=true`` narrows to the entries that posted to an
AR/AP control account **without** touching the subledger, under
``allow_untagged_control`` (ZET-150) — the postings a subledger-vs-control
divergence traces back to.

## Path parameters

- `company_id` string, required

## Query parameters

- `status` string, nullable
- `period_ids` string[], nullable
- `untagged_subledger_control` boolean, nullable
- `q` string, nullable
- `sort` 'entry_no' | 'posting_date' | 'total'
- `order` 'asc' | 'desc'
- `limit` integer
- `offset` integer

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Response `200`

Successful Response

- GlJournalEntriesResponse
  - `journal_entries` GlJournalEntryOut[], required
    - `id` string, required
    - `company_id` string, required
    - `entry_no` integer, nullable
    - `period_id` string, required
    - `posting_date` string, date, required
    - `status` string, required
    - `entry_type` string, required
    - `origin` string, required
    - `description` string, nullable
    - `debit_total_base` string, required
    - `credit_total_base` string, required
    - `line_count` integer, required
    - `version_no` integer, required
    - `reversal_of_entry_id` string, nullable
    - `reversed_by_entry_id` string, nullable
    - `auto_reverse_date` string, date, nullable
    - `coding_guessed` boolean
    - `untagged_subledger_control` boolean
    - `source_ref_type` string, nullable
    - `source_ref_id` string, nullable
    - `source_action` string, nullable
    - `created_at` string, date-time, required
  - `total` integer, 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)