---
title: "Fiscal profile and VAT periods"
method: GET
path: "/v1/reports/fiscal"
tags: ["Reports"]
---

# Fiscal profile and VAT periods

`GET /v1/reports/fiscal`

## Request

- Base URL: `https://api.officina.it`
- URL: `https://api.officina.it/v1/reports/fiscal`
- Auth: HTTP bearer

The fiscal profile that drives the Fiscale tab: `state` is `profile`
(incomplete: show the form), `forfettario` (no VAT) or `full`. Only
with `full` come the liquidation periods (newest first) and
`default_period` — the last completed period, the one the next F24
is about. `regime_locked`: an e-invoice company's regime belongs to
its e-invoice settings and cannot change here. Needs `prices.read`
too.

## Response `200`

The profile.

- ReportFiscal
  - `object` 'report_fiscal', required
  - `profile` ReportFiscalProfile, required
    - `state` 'profile' | 'forfettario' | 'full'
    - `fiscal_regime` string: RF01, RF19, … or empty.
    - `vat_settlement_period` 'monthly' | 'quarterly' | ''
    - `vat_advance_method` 'storico' | 'previsionale' | ''
    - `regime_locked` boolean: The regime belongs to the e-invoice settings.
    - `can_edit` boolean: settings_company.read.
  - `periods` ReportVATPeriod[], required
    - `key` string
    - `label` string
    - `from` string, date
    - `to` string, date
    - `current` boolean: Still running today.
    - `due_date` string, date: F24 deadline.
    - `due_code` string: Codice tributo.
  - `default_period` string

## Other responses

- `401`: Missing, malformed, expired, or wrong-audience bearer token.
- `402`: The company has no active subscription, or its plan does not include API access. API access is included in the Business and Illimitato plans.
- `403`: The authenticated user lacks the required permission.
- `500`: Unhandled server error. Detail is logged, not exposed.

---

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