---
title: "Get status readiness stats for a cohort"
method: GET
path: "/cohorts/{id}/status-readiness"
tags: ["Cohorts"]
---

# Get status readiness stats for a cohort

`GET /cohorts/{id}/status-readiness`

## Request

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

Returns completion percentage for current status phase and whether cohort is ready to advance

## Path parameters

- `id` string, uuid, required

## Response `200`

Status readiness stats retrieved successfully

- object
  - `success` boolean
  - `data` object
    - `currentStatus` string: Current cohort status
    - `tasksCompleted` integer: Number of completed tasks in current status phase
    - `tasksTotal` integer: Total tasks in current status phase
    - `completionPercent` integer: Completion percentage (0-100)
    - `readyToAdvance` boolean: True if >=90% complete
    - `nextStatus` string, nullable: Next status in progression, or null if at final status
    - `previousStatus` string, nullable: Previous status for reverting

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