---
title: "Operational analytics dashboard"
method: GET
path: "/api/analytics/dashboard"
tags: ["analytics"]
---

# Operational analytics dashboard

`GET /api/analytics/dashboard`

## Query parameters

- `period` 'today' | 'week' | 'month' | 'custom'
- `from_date` string, date, nullable
- `to_date` string, date, nullable

## Response `200`

Successful Response

- AnalyticsDashboardResponse
  - `period` DashboardResolvedPeriod, required
    - `preset` 'today' | 'week' | 'month' | 'custom', required
    - `timezone` 'Europe/Rome', required
    - `comparison_kind` 'previous_day' | 'previous_week' | 'previous_month' | 'previous_period', required
    - `current` DashboardPeriodWindow, required
      - `start_at` string, date-time, required
      - `end_at` string, date-time, required
      - `end_exclusive` true
    - `comparison` DashboardPeriodWindow, required
      - `start_at` string, date-time, required
      - `end_at` string, date-time, required
      - `end_exclusive` true
  - `freshness` DashboardFreshness, required
    - `generated_at` string, date-time, required
    - `data_as_of` string, date-time, nullable
    - `refresh_interval_minutes` 15
    - `cycle_id` string, uuid, nullable
    - `is_stale` boolean
  - `summary` DashboardSummarySection, required
    - `metrics` DashboardSummaryMetrics, required
      - `new_entries` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
      - `entered_to_rebook` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
      - `abandonments` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
      - `abandonment_risk` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
      - `frequency_not_respected` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
      - `rebooking_rate` DashboardPercentageMetric, required
        - `value` number, nullable, required
        - `comparison_value` number, nullable, required
        - `delta` number, nullable, required
        - `delta_percentage` unknown
        - `unit` 'percent'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` integer, required
        - `denominator` integer, required
  - `partial_dropouts` DashboardPartialDropoutSection, required
    - `metrics` DashboardPartialDropoutMetrics, required
      - `psychology_partial_dropouts` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
      - `nutrition_partial_dropouts` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
    - `items` DashboardPartialDropoutItem[], required
      - `patient_id` string, uuid, required
      - `patient_name` string, required
      - `abandoned_path` 'psychology' | 'nutrition', required
      - `remaining_path` 'psychology' | 'nutrition', required
      - `remaining_expert_id` string, uuid, nullable
      - `remaining_expert_name` string, nullable
      - `occurred_on` string, date, required
      - `elapsed_days` integer, required
  - `experts` DashboardExpertSection, required
    - `metrics` DashboardExpertMetrics, required
      - `total` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
    - `items` DashboardExpertItem[], required
      - `operator_id` string, uuid, required
      - `name` string, required
      - `profession` 'PSICOLOGO' | 'NUTRIZIONISTA', required — Operator profession constants.
      - `patient_count` integer, required
      - `status` 'regular' | 'attention' | 'risk'
      - `signals` DashboardExpertSignals, required
        - `patients_at_risk` integer
        - `patient_dropouts` integer
        - `frequency_not_respected` integer
  - `supervisors` DashboardSupervisorSection, required
    - `metrics` DashboardSupervisorMetrics, required
      - `total` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
    - `items` DashboardSupervisorItem[], required
      - `supervisor_id` string, uuid, required
      - `name` string, required
      - `area` 'PSICOLOGO' | 'NUTRIZIONISTA' | 'multidisciplinary'
      - `expert_count` integer, required
      - `last_meeting` string, date-time, nullable
      - `open_criticalities` integer, nullable
      - `experts_to_contact` integer, nullable
      - `status` 'regular' | 'attention' | 'risk'
  - `calls` DashboardCallSection, required
    - `metrics` DashboardCallMetrics, required
      - `calls_done` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
      - `bookings_closed_in_call` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
      - `without_next_step` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
      - `call_no_shows` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
    - `items` DashboardCallItem[], required
      - `appointment_id` string, uuid, required
      - `patient_id` string, uuid, required
      - `patient_name` string, required
      - `operator_id` string, uuid, required
      - `operator_name` string, required
      - `call_type` 'CALL_CONOSCITIVA' | 'CALL_GRATUITA', required
      - `occurred_at` string, date-time, required
      - `appointment_status` 'FATTO' | 'DA_RIPROGRAMMARE', required
      - `description` string, nullable
      - `outcome` unknown
      - `next_step_at` string, date-time, nullable
      - `status` 'regular' | 'attention' | 'risk', required
      - `alert_type` 'no_show' | 'without_next_step', required
  - `multidisciplinary_reports` DashboardReportSection, required
    - `metrics` DashboardReportMetrics, required
      - `reports_expected` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
      - `reports_completed` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
      - `reports_incomplete` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
      - `missing_psychology` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
      - `missing_nutrition` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
      - `missing_both` DashboardCountMetric, required
        - `value` integer, required
        - `comparison_value` integer, required
        - `delta` integer, required
        - `delta_percentage` number, nullable
        - `unit` 'count'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `numerator` unknown
        - `denominator` unknown
    - `items` DashboardReportItem[], required
      - `report_id` string, uuid, required
      - `patient_id` string, uuid, nullable
      - `patient_name` string, nullable
      - `created_at` string, date-time, required
      - `completion_status` 'missing_psychology' | 'missing_nutrition' | 'missing_both', required
      - `comparison_status` unknown

## Other responses

- `422` — Validation Error

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/corabea/corabea-api/revisions/13c1bce1bdc4/schema)