---
title: "List matching sessions for a cohort (MED-829 / E23-8)"
method: GET
path: "/api/cohorts/{cohortId}/matching-sessions"
tags: ["MatchingSessions"]
---

# List matching sessions for a cohort (MED-829 / E23-8)

`GET /api/cohorts/{cohortId}/matching-sessions`

## Request

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

Returns all `matching_sessions` rows for the cohort that are NOT
`expired` and NOT soft-deleted, sorted by `updated_at DESC`. Each row
includes the owner's display fields (first_name, last_name, avatar_url)
fetched via a single LEFT JOIN. The cohort Groups tab sessions panel
polls this endpoint every 30 s.

The list is intentionally small (per cohort, typically 1-3 rows) so
there is no pagination.

## Path parameters

- `cohortId` string, uuid, required

## Response `200`

Array of matching session list items.

- object
  - `success` boolean
  - `data` object[]
    - `id` string, uuid
    - `cohort_id` string, uuid
    - `external_session_id` string, nullable: matching-server's id; populated after leg (C). Not unique under the 1:N model.
    - `opened_by_admin_id` string, uuid
    - `status` 'submitting' | 'ready' | 'in_progress' | 'awaiting_finalize' | 'completed' | 'failed' | 'expired'
    - `error_message` string, nullable
    - `time_slot_id_to_identifier` object, nullable
    - `data_as_of_at` string, date-time, nullable
    - `received_at` string, date-time, nullable
    - `rep_name` string, nullable
    - `user_in_valid` boolean, nullable
    - `created_at` string, date-time
    - `updated_at` string, date-time
    - `owner_first_name` string, nullable
    - `owner_last_name` string, nullable
    - `owner_avatar_url` string, nullable

## Other responses

- `401`: Unauthorized — missing or invalid SGOS admin session.
- `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)