---
title: "List Client Activity"
method: GET
path: "/api/autopilot/clients/activity"
tags: ["autopilot"]
---

# List Client Activity

`GET /api/autopilot/clients/activity`

## Request

- Base URL: `https://api.taxcompass.it` (the document declares no server; this is the origin it was published from)
- URL: `https://api.taxcompass.it/api/autopilot/clients/activity`
- Auth: HTTP bearer

Each client's relationship in money: owed now, invoiced and collected in
``year``, last invoice, average days to pay.

A separate read rather than fields on ``ClientRead``, because ``ClientRead``
is also what the edit form round-trips: a figure there would be something a
PUT could appear to write. Declared before ``/clients/{client_id}`` so the
literal segment is not parsed as an id.

``year`` defaults to the server's current year, as ``/incassi`` does. A
client with no issued document has no entry — the table renders its absence
as "nothing yet", not as a row of zeros.

## Query parameters

- `year` integer, nullable

## Response `200`

Successful Response

- ClientActivity[]
  - `client_id` string, uuid, required
  - `year` integer, required
  - `outstanding` string
  - `overdue` string
  - `invoiced` string
  - `collected` string
  - `last_invoice_date` string, date, nullable
  - `avg_days_to_pay` integer, nullable
  - `paid_invoices` integer

## Other responses

- `422`: Validation Error

---

[API](https://skmtc.dev/taxcompass/apis/taxcompass-api.md) · [All operations](https://skmtc.dev/taxcompass/apis/taxcompass-api/llms.txt) · [OpenAPI document](https://skmtc.dev/taxcompass/apis/taxcompass-api/revisions/fef5fc6a9b91?raw)