---
title: "List Company Aliases"
method: GET
path: "/companies/{company_id}/aliases"
tags: ["companies"]
---

# List Company Aliases

`GET /companies/{company_id}/aliases`

## 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}/aliases`
- Auth: none declared

The company's registered trading names.

A company may issue and receive documents under a brand or trading name while one
legal entity stands behind it. Registering the name here is what lets document
analysis recognise such a document as the company's own instead of parking it as
"not this company" and defaulting it to payable.

Readable by any member; **writing** needs accountant-or-owner (below).

``CompanyMember`` is declared rather than left to ``load_company``'s implicit
404/403 split: every sibling list route in this router declares it, the generated
contract row reads the dependency (without it the row said ``user`` while this
docstring said "any member"), and ``deps`` warns that gating which depends on call
ordering is how deny-by-default silently inverts. It costs nothing — the
dependency is cached against the same lookup.

## Path parameters

- `company_id` string, required

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Response `200`

Successful Response

- CompanyAliasList: ``GET /companies/<id>/aliases`` → the company's registered trading names.
  - `aliases` CompanyAliasOut[], required
    - `id` string, required
    - `name` 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)