---
title: "Monthly dropouts grouped by total sessions"
method: GET
path: "/api/analytics/dropouts/sessions-monthly"
tags: ["analytics"]
---

# Monthly dropouts grouped by total sessions

`GET /api/analytics/dropouts/sessions-monthly`

Returns per-month dropouts grouped by total completed sessions with patient contact details from analytics_dropouts_sessions_monthly.

## Query parameters

- `from_date` string, date, nullable — Start month (first day of month, YYYY-MM-DD). Default 2000-01-01.
- `to_date` string, date, nullable — End month (first day of month, YYYY-MM-DD). Default today.

## Response `200`

Successful Response

- DropoutsSessionsMonthlyResponse — Dropouts sessions monthly response model.
  - `items` DropoutsSessionsMonthlyRow[], required — One row per (month, sessions_total) with dropouts_count and patients
    - `month` string, required — Month as YYYY-MM
    - `sessions_total` integer, required — Total completed sessions (lifetime) for these patients
    - `dropouts_count` integer, required — Number of dropouts in this month with this sessions_total
    - `total_month` integer, nullable — Total dropouts in this month (all buckets)
    - `patients` AnalyticsPatientContactRow[] — Patient contact details in this bucket
      - `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
      - `phone` string, nullable — User phone

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