---
title: "List Gl Coding Siblings"
method: GET
path: "/companies/{company_id}/gl/items/{item_id}/coding-siblings"
tags: ["gl-actions"]
---

# List Gl Coding Siblings

`GET /companies/{company_id}/gl/items/{item_id}/coding-siblings`

## 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/items/{item_id}/coding-siblings`
- Auth: none declared

This counterparty's other held documents that take the same coding (ZET-116).

**Read-only plan, no booking.** Coding is forward-only, so coding one supplier
invoice by hand leaves every other already-analysed invoice from that supplier held
for ever. This answers "which of them can I book the same way, and for how much?":
same counterparty, same direction, still held with an AI coding proposal, and their
own figures agreeing with the ``(account_code, vat_code)`` pair you send. Everything
it refuses comes back in ``skipped`` with a reason. The caller books each candidate
through ``POST …/gl/items/{item_id}/coding`` one at a time, so each row commits on
its own and the run can be stopped.

Errors: 404 missing/cross-tenant item; 422 anchor without a counterparty or a
direction, unknown VAT code, or an account that may not be applied to a batch
(a control, contra or wrong-category account).

## Path parameters

- `company_id` string, required
- `item_id` string, required

## Query parameters

- `account_code` string, required
- `vat_code` string, nullable

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Response `200`

Successful Response

- GlCodingSiblingsOut: Response of ``GET /companies/{id}/gl/items/{item_id}/coding-siblings``. A **plan**, not an action: the caller books each candidate through the ordinary ``POST …/gl/items/{item_id}/coding`` endpoint, one request at a time, so every row commits on its own and the batch stays interruptible.
  - `counterparty_id` string, required
  - `counterparty_name` string, nullable
  - `direction` string, required
  - `account_code` string, required
  - `vat_code` string, nullable
  - `count` integer, required
  - `siblings` GlCodingSiblingOut[]
    - `item_id` string, required
    - `decision_id` string, required
    - `document_no` string, nullable
    - `invoice_date` string, date, nullable
    - `net_amount_cents` integer, required
    - `gross_cents` integer, required
    - `currency` string, nullable
    - `label` string, required
    - `precedent_conflict` boolean
  - `skipped` GlCodingSiblingSkipOut[]
    - `item_id` string, required
    - `code` string, required
    - `reason` string, required
    - `label` 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)