> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hawkings.education/llms.txt
> Use this file to discover all available pages before exploring further.

# List cohorts

## Query

<ParamField query="course_id" type="string" />

<ParamField query="workspace_id" type="string" />

<ParamField query="status" type="enum">`upcoming` | `active` | `archived`.</ParamField>

<ParamField query="limit" type="integer" default="20" />

<ParamField query="starting_after" type="string" />

## Examples

<CodeGroup>
  ```ts TypeScript theme={null}
  const page = await hk.cohorts.list({ course_id: "crs_123", status: "active" });
  ```

  ```php PHP theme={null}
  $page = $hk->cohorts->list(['course_id' => 'crs_123', 'status' => 'active']);
  ```
</CodeGroup>

## Returns

A paginated list of [Cohort](/api-reference/cohorts/object) objects.