---
title: "Read F24"
method: GET
path: "/api/autopilot/f24"
tags: ["autopilot"]
---

# Read F24

`GET /api/autopilot/f24`

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

The year's F24 payments — sezione, codice tributo, anno, importo (AP-061b).

A read that writes, on purpose. The calendar is recomputed from the ledger on
every call and handed to ``f24_store.regenerate``, which upserts on
``(user, tax_year, kind)`` — so opening the page twice does not stack a second
saldo, and a payment recorded this morning moves the amount instead of leaving
a stale one on screen. A ``confirmed_paid`` row is skipped by that upsert and
survives untouched; a ``proposed`` one the calendar no longer implies is swept.

Same gates and the same 422 details as ``/deadlines`` (:func:`_calendar_or_422`):
an F24 is the calendar made payable, so it may not exist where the calendar
refuses to. ``year`` is the **tax year**; the instalments themselves fall in the
year after, which each record states in its own ``due_*`` fields.

## Query parameters

- `year` integer, nullable

## Response `200`

Successful Response

- F24Record[]
  - `id` string, uuid, required
  - `tax_year` integer, required
  - `kind` string, required
  - `status` 'proposed' | 'confirmed_paid'
  - `rows` F24Line[]
    - `sezione` string, required
    - `codice_tributo` string, required
    - `anno_riferimento` integer, required
    - `importo` string, required
  - `total` string
  - `due_year` integer, nullable
  - `due_month` integer, nullable
  - `due_day` integer, nullable
  - `due_date` string, date, nullable
  - `paid_at` string, date-time, nullable
  - `created_at` string, date-time, nullable
  - `updated_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)