---
title: "Call informativa stats"
method: GET
path: "/api/analytics/free-calls"
tags: ["analytics"]
---

# Call informativa stats

`GET /api/analytics/free-calls`

Returns call informativa metrics in selected period: FATTO, DA_RIPROGRAMMARE, ANNULLATO, conversion to CALL_CONOSCITIVA, and per-operator stats for customer_care role.

## Query parameters

- `from_date` string, date, required — Filter: appointment_datetime >= from_date (YYYY-MM-DD).
- `to_date` string, date, required — Filter: appointment_datetime <= end of to_date (YYYY-MM-DD).
- `operator_id` string, uuid, nullable — Optional filter by operator UUID.

## Response `200`

Successful Response

- FreeCallsStatsResponse — Free calls analytics response model.
  - `filters` FreeCallsStatsFilters, required — Free calls analytics filters model.
    - `from_date` string, date, required — Filter: appointment_datetime >= from_date
    - `to_date` string, date, required — Filter: appointment_datetime <= end of to_date
    - `operator_id` string, uuid, nullable — Optional filter by operator UUID
  - `summary` FreeCallsStatsSummary, required — Free calls aggregate summary.
    - `free_calls_done` integer, required — Number of CALL_GRATUITA with status FATTO in the period
    - `free_calls_to_reschedule` integer, required — Number of CALL_GRATUITA with status DA_RIPROGRAMMARE in the period
    - `free_calls_canceled` integer, required — Number of CALL_GRATUITA with status ANNULLATO in the period
    - `converted_to_call_conoscitiva` integer, required — Number of done free calls whose patient later booked a CALL_CONOSCITIVA (status DA_FARE/FATTO/DA_RIPROGRAMMARE)
    - `avg_hours_to_call_conoscitiva_booking` number, nullable — Average hours from done free call datetime to CALL_CONOSCITIVA booking created_at
    - `avg_days_to_call_conoscitiva_booking` number, nullable — Average days from done free call datetime to CALL_CONOSCITIVA booking created_at
    - `conversion_rate_pct` number, required — converted_to_call_conoscitiva / free_calls_done * 100
  - `customer_care_operators` FreeCallsStatsByOperatorRow[] — Per-operator metrics for operators with Keycloak role customer_care
    - `operator_id` string, uuid, required — Operator UUID
    - `operator_user_id` string, uuid, required — Operator user UUID
    - `operator_name` string, required — Operator display name
    - `operator_email` string, nullable — Operator email
    - `free_calls_done` integer, required — Done free calls assigned to this operator
    - `free_calls_to_reschedule` integer, required — To-reschedule free calls assigned to this operator
    - `free_calls_canceled` integer, required — Canceled free calls assigned to this operator
    - `converted_to_call_conoscitiva` integer, required — Done free calls assigned to this operator with later CALL_CONOSCITIVA booking
    - `avg_hours_to_call_conoscitiva_booking` number, nullable — Average hours from done free call datetime to CALL_CONOSCITIVA booking created_at for this operator
    - `avg_days_to_call_conoscitiva_booking` number, nullable — Average days from done free call datetime to CALL_CONOSCITIVA booking created_at for this operator
    - `conversion_rate_pct` number, required — converted_to_call_conoscitiva / free_calls_done * 100
  - `daily_trend` FreeCallsDailyTrendRow[] — Daily trend for charting in the selected period
    - `day` string, date, required — Day in the selected period
    - `free_calls_done` integer, required — Number of CALL_GRATUITA with status FATTO on this day
    - `free_calls_to_reschedule` integer, required — Number of CALL_GRATUITA with status DA_RIPROGRAMMARE on this day
    - `free_calls_canceled` integer, required — Number of CALL_GRATUITA with status ANNULLATO on this day
    - `converted_to_call_conoscitiva` integer, required — Done free calls on this day whose patient later booked CALL_CONOSCITIVA
    - `conversion_rate_pct` number, required — converted_to_call_conoscitiva / free_calls_done * 100

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