---
title: "Dealership report widget"
method: GET
path: "/v1/dealership-report/{widget}"
tags: ["Reports"]
---

# Dealership report widget

`GET /v1/dealership-report/{widget}`

## Request

- Base URL: `https://api.officina.it`
- URL: `https://api.officina.it/v1/dealership-report/{widget}`
- Auth: HTTP bearer

the Situazione Concessionaria dashboard, mirroring the officina
report surface (one route per widget, progressive loading, the
same date filter as the list endpoints).

Widget keys:

kpis                    the web KPI row bundled: vehicles-sold,
total-revenue, total-margin, average-days,
average-profit-per-vehicle,
immobilized-capital, loss-sales-percentage,
average-markup-percentage — each with the
previous-period delta
sales-chart             revenue + margin series per period bucket
top-profitable-sales    ranked best sales by profit
bottom-profitable-sales ranked worst sales by profit
top-giacenza-sales      fastest vehicles (lowest days in stock)
bottom-giacenza-sales   slowest vehicles (highest days in stock)

Gate: dealership.read + reports.read, like the web dashboard (the
module flag gates the menu client-side).

## Query parameters

- `from` string
- `preset` 'rel30' | 'rel90' | 'rel365' | 'year' | 'Q1' | 'Q2' | 'Q3' | 'Q4' | 'month' | 'custom' | 'all'
- `to` string

## Response `200`

success

## 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.
- `404`: Resource does not exist OR belongs to a different company. The two cases are intentionally indistinguishable.
- `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)