---
title: "List all cohorts"
method: GET
path: "/cohorts"
tags: ["Cohorts"]
---

# List all cohorts

`GET /cohorts`

## Request

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

Get a paginated list of cohorts with optional filtering

## Query parameters

- `search` string
- `status` string
- `partnerId` string, uuid
- `programId` string, uuid
- `page` integer
- `limit` integer

## Response `200`

Cohorts retrieved successfully

- object
  - `success` boolean
  - `data` Cohort[]
    - `id` string, uuid
    - `partner_id` string, uuid
    - `program_id` string, uuid
    - `name` string
    - `short_name` string
    - `code` string
    - `description` string
    - `status` 'setup' | 'ready' | 'live' | 'paused' | 'completed' | 'cancelled'
    - `cohort_type` string
    - `start_date` string, date
    - `end_date` string, date
    - `preferred_days` string[]
    - `preferred_times` string[]
    - `participant_capacity` integer
    - `is_active` boolean
    - `created_at` string, date-time
  - `pagination` object

## Other responses

- `401`: Unauthorized

---

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