---
title: "List groups in a cohort with optional pagination and search"
method: GET
path: "/cohorts/{cohortId}/groups"
tags: ["Groups"]
---

# List groups in a cohort with optional pagination and search

`GET /cohorts/{cohortId}/groups`

## Request

- Base URL: `https://api.production.yourmedley.com`
- URL: `https://api.production.yourmedley.com/cohorts/{cohortId}/groups`
- Auth: none declared

Returns groups for a cohort with member counts and coach info. Supports server-side pagination via limit/offset and search by group name or participant name/email. When no limit is provided, returns all groups.

## Path parameters

- `cohortId` string, uuid, required

## Query parameters

- `limit` integer
- `offset` integer
- `search` string

## Response `200`

Paginated list of groups

- object
  - `success` boolean
  - `data` object
    - `data` GroupWithMembers[]
      - `id` string, uuid
      - `cohort_id` string, uuid
      - `name` string
      - `description` string
      - `max_size` integer
      - `coach_id` string, uuid
      - `is_active` boolean
      - `member_count` integer
      - `created_at` string, date-time
      - `updated_at` string, date-time
      - `members` GroupMember[]
        - `user_id` string, uuid
        - `first_name` string
        - `last_name` string
        - `email` string
        - `title` string
        - `joined_at` string, date-time
    - `pagination` object
      - `total` integer: Total number of groups matching the query
      - `limit` integer
      - `offset` integer
      - `hasMore` boolean: Whether more groups are available beyond the current page

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