---
title: "Experts in scope with their operational indicators"
method: GET
path: "/api/expert-performance/experts"
tags: ["expert-performance"]
---

# Experts in scope with their operational indicators

`GET /api/expert-performance/experts`

## Request

- Base URL: `https://api.corabea.it` (the document declares no server; this is the origin it was published from)
- URL: `https://api.corabea.it/api/expert-performance/experts`
- Auth: HTTP bearer

## Query parameters

- `status` 'regular' | 'attention' | 'risk'
- `search` string, nullable
- `profession` 'PSICOLOGO' | 'NUTRIZIONISTA': Operator profession constants.
- `supervisor_id` string, uuid, nullable
- `tenure` 'new' | 'established', nullable: Platform seniority at the end date; new uses ANALYTICS_NEW_EXPERT_DAYS.
- `sort_by` 'priority' | 'name' | 'patient_count' | 'toolbox' | 'frequency' | 'dropouts' | 'rebooking' | 'tickets' | 'management'
- `sort_dir` 'asc' | 'desc'
- `activity` 'active' | 'inactive' | 'all'
- `overdue_avvisi` boolean: Only the experts a supervisor's trend avviso expired about, and those supervisors.
- `from_date` string, date, required
- `to_date` string, date, required
- `per_page` integer
- `page` integer

## Response `200`

Successful Response

- DashboardExpertDetailsResponse
  - `period` DashboardResolvedPeriod, required
    - `preset` 'today' | 'yesterday' | 'week' | 'month' | 'this_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
  - `status` 'regular' | 'attention' | 'risk', required
  - `counts` object
  - `items` DashboardExpertItem[], required
    - `operator_id` string, uuid, required
    - `operator_status` string, nullable
    - `name` string, required
    - `profession` 'PSICOLOGO' | 'NUTRIZIONISTA', required: Operator profession constants.
    - `supervisor_names` string[]
    - `coordinator_names` string[]
    - `overdue_avviso_supervisors` string[]: Supervisors whose avviso about this expert's trend is past its deadline.
    - `overdue_supervisee_avvisi` integer: As a supervisor: how many avvisi about their supervisees are past the deadline.
    - `patient_count` integer, required
    - `last_assignment_at` string, date-time, nullable
    - `patient_status_counts` object
    - `toolbox_patients` integer
    - `toolbox_materials` integer
    - `toolbox_total_patients` integer
    - `toolbox_missing_patients` integer
    - `toolbox_status` 'regular' | 'attention' | 'risk'
    - `status` 'regular' | 'attention' | 'risk', required
    - `comparison_status` 'regular' | 'attention' | 'risk', required
    - `criteria` DashboardExpertCriteria, required
      - `frequency_compliance` DashboardExpertPercentageCriterion, required
        - `actionable_count` integer
        - `value` number, nullable, required
        - `comparison_value` number, nullable, required
        - `delta` number, nullable, required
        - `status` 'regular' | 'attention' | 'risk', required
        - `comparison_status` 'regular' | 'attention' | 'risk', required
        - `numerator` integer, required
        - `denominator` integer, required
        - `comparison_numerator` integer, nullable, required
        - `comparison_denominator` integer, nullable, required
        - `unit` 'percent'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
      - `rebooking` DashboardExpertPercentageCriterion, required
        - `actionable_count` integer
        - `value` number, nullable, required
        - `comparison_value` number, nullable, required
        - `delta` number, nullable, required
        - `status` 'regular' | 'attention' | 'risk', required
        - `comparison_status` 'regular' | 'attention' | 'risk', required
        - `numerator` integer, required
        - `denominator` integer, required
        - `comparison_numerator` integer, nullable, required
        - `comparison_denominator` integer, nullable, required
        - `unit` 'percent'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
      - `continuity` DashboardExpertContinuityCriterion, required
        - `value` number, nullable, required
        - `comparison_value` number, nullable, required
        - `delta` number, nullable, required
        - `status` 'regular' | 'attention' | 'risk', required
        - `comparison_status` 'regular' | 'attention' | 'risk', required
        - `unit` 'percent'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
        - `initial` DashboardExpertRate, required
          - `value` number, nullable, required
          - `numerator` integer, required
          - `denominator` integer, required
        - `overall` DashboardExpertRate, required
          - `value` number, nullable, required
          - `numerator` integer, required
          - `denominator` integer, required
        - `comparison_initial` DashboardExpertRate, required
          - `value` number, nullable, required
          - `numerator` integer, required
          - `denominator` integer, required
        - `comparison_overall` DashboardExpertRate, required
          - `value` number, nullable, required
          - `numerator` integer, required
          - `denominator` integer, required
      - `alerts_and_reports` DashboardExpertTicketCriterion, required
        - `value` integer, required
        - `comparison_value` integer, nullable, required
        - `delta` integer, nullable, required
        - `status` 'regular' | 'attention' | 'risk', required
        - `comparison_status` 'regular' | 'attention' | 'risk', required
        - `alerts` integer, required
        - `reports` integer, required
        - `comparison_alerts` integer, nullable, required
        - `comparison_reports` integer, nullable, required
        - `unit` 'points'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
      - `multidisciplinary_continuity` DashboardExpertPercentageCriterion, required
        - `actionable_count` integer
        - `value` number, nullable, required
        - `comparison_value` number, nullable, required
        - `delta` number, nullable, required
        - `status` 'regular' | 'attention' | 'risk', required
        - `comparison_status` 'regular' | 'attention' | 'risk', required
        - `numerator` integer, required
        - `denominator` integer, required
        - `comparison_numerator` integer, nullable, required
        - `comparison_denominator` integer, nullable, required
        - `unit` 'percent'
        - `measurement_kind` 'period_event' | 'period_entry' | 'period_end_snapshot', required
  - `total` integer, required
  - `per_page` integer, required
  - `page` integer, required

## Other responses

- `422`: Validation Error

## Changes

- **2026-10-20** `d8cdee1d5474`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/corabea/apis/corabea-api/changes/api/expert-performance/experts/get.md)

---

[API](https://skmtc.dev/corabea/apis/corabea-api.md) · [All operations](https://skmtc.dev/corabea/apis/corabea-api/llms.txt) · [OpenAPI document](https://skmtc.dev/corabea/apis/corabea-api/revisions/4a8dd89893b8?raw)