---
title: "List Expense Claims"
method: GET
path: "/companies/{company_id}/expenses/claims"
tags: ["payroll"]
---

# List Expense Claims

`GET /companies/{company_id}/expenses/claims`

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

## Path parameters

- `company_id` string, required

## Query parameters

- `status` 'draft' | 'submitted' | 'approved' | 'rejected' | 'reimbursed' | 'cancelled': Expense-claim lifecycle (SP9; guide §5.5 "locked, auditable approval states"): immutable from ``approved`` on — corrections only via cancel (reverse) + a new claim.
- `employee_id` string, nullable
- `year` integer, nullable

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Response `200`

Successful Response

- ExpenseClaimsResponse
  - `claims` ExpenseClaimOut[], required
    - `id` string, required
    - `employee_id` string, required
    - `claim_no` integer, required
    - `status` 'draft' | 'submitted' | 'approved' | 'rejected' | 'reimbursed' | 'cancelled', required: Expense-claim lifecycle (SP9; guide §5.5 "locked, auditable approval states"): immutable from ``approved`` on — corrections only via cancel (reverse) + a new claim.
    - `reimburse_via` 'payroll' | 'ap', required: How an approved claim's employee-payable open item settles: fed to a payroll run (6000 line + clearing settlement, MASTER R5) or paid directly via e-banking + bank reconciliation (MASTER R21).
    - `currency` string, required
    - `purpose` string, nullable, required
    - `total_gross` string, required
    - `reimbursable_gross` string, required
    - `submitted_at` string, date-time, nullable, required
    - `approved_at` string, date-time, nullable, required
    - `rejected_reason` string, nullable, required
    - `commercial_document_id` string, nullable, required
    - `open_item_id` string, nullable, required
    - `journal_entry_id` string, nullable, required
    - `payroll_run_id` string, nullable, required
    - `reimbursed_at` string, date-time, nullable, required
    - `created_at` string, date-time, 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)
