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

# List participants across multiple cohorts

`GET /api/data-library/participants`

## Request

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

Returns enriched participant data across multiple cohorts including group assignment, coach, attendance stats, active flags, survey completion status, and last email date.

## Query parameters

- `cohortIds` string, required
- `page` integer
- `limit` integer
- `sortBy` string
- `sortOrder` 'ASC' | 'DESC'
- `search` string
- `status` 'pending' | 'active' | 'withdrawn'
- `groupId` string
- `coachId` string, uuid
- `department` string
- `location` string
- `flaggedOnly` boolean
- `hasAbsences` boolean
- `midpointCompleted` boolean
- `endpointCompleted` boolean

## Response `200`

Participants retrieved successfully

- object
  - `success` boolean
  - `data` DataLibraryParticipant[]
    - `id` string, uuid
    - `user_id` string, uuid
    - `cohort_id` string, uuid
    - `first_name` string
    - `last_name` string
    - `email` string, email
    - `status` 'pending' | 'active' | 'withdrawn'
    - `cohort_name` string
    - `group_name` string, nullable
    - `coach_name` string, nullable
    - `attendance_percentage` integer, nullable
    - `has_open_flag` boolean
    - `flag_severity` 'high' | 'medium' | 'low', nullable
  - `meta` object
    - `pagination` object
    - `filterOptions` object

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