---
title: "List participants for a cohort"
method: GET
path: "/cohorts/{cohortId}/participants"
tags: ["Participants"]
---

# List participants for a cohort

`GET /cohorts/{cohortId}/participants`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/cohorts/{cohortId}/participants`
- Auth: HTTP bearer

Get a paginated list of participants with optional filtering

## Path parameters

- `cohortId` string, uuid, required

## Query parameters

- `search` string
- `status` 'pending' | 'active' | 'withdrawn'
- `groupId` string, uuid
- `flaggedOnly` 'true' | 'false'
- `page` integer
- `limit` integer

## Response `200`

Participants retrieved successfully

- object
  - `success` boolean
  - `data` Participant[]
    - `id` string, uuid
    - `cohort_id` string, uuid
    - `user_id` string, uuid
    - `first_name` string
    - `last_name` string
    - `email` string, email
    - `status` 'pending' | 'active' | 'withdrawn'
    - `personality_type` string
    - `title` string
    - `department` string
    - `location` string
    - `custom_fields` object
    - `group_id` string, uuid
    - `group_name` string
    - `enrolled_at` string, date-time
  - `meta` object
    - `pagination` object
    - `summary` 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)