---
title: "List Incassi"
method: GET
path: "/api/autopilot/incassi"
tags: ["autopilot"]
---

# List Incassi

`GET /api/autopilot/incassi`

## 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/incassi`
- Auth: HTTP bearer

One tax year of the cash-basis ledger, newest payment first.

``year`` defaults to the server's current year for the same reason
``/status`` reports it: the browser clock may sit in another timezone on
31 December and silently ask for the wrong year.

## Query parameters

- `year` integer, nullable

## Response `200`

Successful Response

- IncassiYear: ``GET /api/autopilot/incassi?year=`` — one tax year of the cash-basis ledger. ``total`` is the year's collected revenue: the number the forfettario estimate (AP-037) is computed from, and the one measured against the 85 000 € ceiling. It covers exactly the payments in ``items``.
  - `year` integer, required
  - `total` string
  - `count` integer
  - `items` IncassoRead[]
    - `id` string, uuid, required
    - `invoice_id` string, uuid, nullable
    - `amount` string, required
    - `received_date` string, date, required
    - `ateco` string, nullable
    - `method` 'bank' | 'card' | 'cash' | 'other', nullable
    - `note` string, nullable
    - `created_at` string, date-time, nullable

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