---
title: "Status transitions in a period"
method: GET
path: "/api/analytics/overview/transitions"
tags: ["analytics"]
---

# Status transitions in a period

`GET /api/analytics/overview/transitions`

Returns status transitions (psychologist/nutritionist) aggregated by month from analytics_transitions. Coordinator sees only their supervisors' data.

## Query parameters

- `from_date` string, date, required — Start date (YYYY-MM-DD).
- `to_date` string, date, required — End date (YYYY-MM-DD).

## Response `200`

Successful Response

- AnalyticsTransitionsResponse — Analytics transitions response model.
  - `items` AnalyticsTransitionRow[], required — Transition rows in the period
    - `month_start` string, date, required — First day of the month
    - `month_end` string, date, required — Last day of the month
    - `path_type` string, required — PSYCHOLOGIST or NUTRITIONIST
    - `from_status` string, required — Previous status
    - `to_status` string, required — New status
    - `patients_count` integer, required — Number of patients in this transition
    - `patients_detail` TransitionPatientDetail[], required — List of patients (id, first_name, last_name, email)
      - `patient_id` string, uuid, required — Patient UUID
      - `first_name` string, nullable — User first name
      - `last_name` string, nullable — User last name
      - `email` string, nullable — User email

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