---
title: "List session summary data across multiple cohorts"
method: GET
path: "/api/data-library/sessions"
tags: ["DataLibrary"]
---

# List session summary data across multiple cohorts

`GET /api/data-library/sessions`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/api/data-library/sessions`
- Auth: HTTP bearer

Returns one row per group session with attendance summary data, per-participant attendance status array, and aggregate metrics. By default returns only completed sessions. Pass sessionStatus=upcoming to retrieve not-yet-completed sessions, or sessionStatus=flagged to retrieve sessions with active, undismissed health alerts. Session Week and Session Month are derived client-side from session_date.

## Query parameters

- `cohortIds` string, required
- `page` integer
- `limit` integer
- `sortBy` string
- `sortOrder` 'ASC' | 'DESC'
- `search` string
- `cohortId` string, uuid
- `groupId` string
- `coachId` string, uuid
- `sessionMonth` string
- `sessionNumber` string
- `sessionStatus` 'completed' | 'upcoming' | 'flagged'

## Response `200`

Session summary data retrieved successfully

## Other responses

- `400`: Bad request - missing cohortIds
- `401`: Unauthorized
- `500`: Internal server error

---

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