---
title: "Get health summary with alerts for a cohort"
method: GET
path: "/cohorts/{id}/health-summary"
tags: ["Cohort Health"]
---

# Get health summary with alerts for a cohort

`GET /cohorts/{id}/health-summary`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/cohorts/{id}/health-summary`
- Auth: HTTP bearer

Computes health alerts on-the-fly from attendance, engagement, feedback, and survey data. Returns tiered alerts (risk, monitor, on-track) with metrics and trends.

## Path parameters

- `id` string, uuid, required

## Response `200`

Health summary retrieved successfully

- object
  - `success` boolean
  - `data` object
    - `overallStatus` 'at_risk' | 'monitor' | 'on_track'
    - `statusMessage` string
    - `metrics` object
    - `tiers` object

## Other responses

- `401`: Unauthorized
- `404`: Cohort not found

---

[API](https://skmtc.dev/withmedley/apis/medley-api.md) - [All operations](https://skmtc.dev/withmedley/apis/medley-api/llms.txt) - [OpenAPI document](https://skmtc.dev/withmedley/apis/medley-api/revisions/40aaac5ca6bd?raw)