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

# The Cohort object

> A run of a Course for a group of students at a moment in time.

```json Example theme={null}
{
  "id": "coh_01HX9N5AB3...",
  "object": "cohort",
  "course_id": "crs_01HX9...",
  "name": "Fall 2026, Group A",
  "code": "PHYS-201-FA26-A",
  "language": "en",
  "starts_at": "2026-09-01",
  "ends_at": "2026-12-15",
  "status": "active",
  "students_count": 38,
  "teachers_count": 2,
  "metadata": {},
  "created_at": "2026-05-10T12:00:00Z"
}
```

## Attributes

<ResponseField name="id" type="string">Prefix `coh_`.</ResponseField>
<ResponseField name="course_id" type="string">Parent [Course](/api-reference/courses/object).</ResponseField>

<ResponseField name="name" type="string" />

<ResponseField name="code" type="string | null">Your registrar-style code; unique within a course.</ResponseField>
<ResponseField name="language" type="string">Defaults to the course language; overridable.</ResponseField>
<ResponseField name="starts_at" type="string | null">ISO date.</ResponseField>

<ResponseField name="ends_at" type="string | null" />

<ResponseField name="status" type="enum">`upcoming` | `active` | `archived`.</ResponseField>

<ResponseField name="students_count" type="integer" />

<ResponseField name="teachers_count" type="integer" />

<ResponseField name="metadata" type="object" />

<ResponseField name="lessons" type="Lesson[]">Expand `lessons` to inline.</ResponseField>