---
title: "Customer Account Statement"
method: GET
path: "/companies/{company_id}/ar/customers/{counterparty_id}/account-statement"
tags: ["ar-invoices"]
---

# Customer Account Statement

`GET /companies/{company_id}/ar/customers/{counterparty_id}/account-statement`

## 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}/ar/customers/{counterparty_id}/account-statement`
- Auth: none declared

One customer's statement of account over a period (member read; ZET-433).

Opening balance at ``date_from − 1``, every invoice, credit note, payment, write-off and
reversal dated in ``[date_from, date_to]`` with a running balance, and the closing
balance — all in the company base currency. The closing balance ties out to
``GET …/ar/aging?as_of=date_to`` for this customer (see the response's
``open_items_total`` / ``open_credit_notes`` / ``unapplied``).

## Path parameters

- `company_id` string, required
- `counterparty_id` string, required

## Query parameters

- `date_from` string, date, required
- `date_to` string, date, required

## Headers

- `authorization` string, nullable

## Cookies

- `access_token` string, nullable

## Response `200`

Successful Response

- AccountStatement: A customer's or supplier's statement of account over a period (ZET-432, ZET-433). ``closing_balance`` ties out to the aging report at ``date_to``: ``closing_balance = open_items_total − open_credit_notes + unapplied``, where ``open_items_total`` is the party's row of ``GET …/ar/aging`` (``…/ap/aging`` for a supplier) with ``as_of = date_to``, ``open_credit_notes`` the party's open credit notes of the OTHER direction (a customer credit note is booked as a payable, R2-18), and ``unapplied`` any over-settlement (a negative item balance the aging floors at zero).
  - `counterparty_id` string, required
  - `counterparty_name` string, required
  - `direction` string, required
  - `currency` string, required
  - `date_from` string, required
  - `date_to` string, required
  - `opening_balance` string, required
  - `closing_balance` string, required
  - `total_debit` string, required
  - `total_credit` string, required
  - `open_items_total` string, required
  - `open_credit_notes` string, required
  - `unapplied` string, required
  - `has_unconverted_booking` boolean, required
  - `lines` AccountStatementLine[], required
    - `posting_date` string, required
    - `journal_entry_id` string, nullable, required
    - `entry_no` integer, nullable, required
    - `description` string, nullable, required
    - `open_item_id` string, required
    - `item_direction` string, required
    - `doc_type` string, nullable, required
    - `document_no` string, nullable, required
    - `source_ref_type` string, nullable, required
    - `source_ref_id` string, nullable, required
    - `is_reversal` boolean, required
    - `is_opening` boolean, required
    - `debit` string, required
    - `credit` string, required
    - `balance` string, required
    - `document_amount` string, nullable
    - `document_currency` string, nullable

## 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)