---
title: "Returns a list of semesters"
method: GET
path: "/api/v2/host/semesters"
tags: ["host"]
---

# Returns a list of semesters

`GET /api/v2/host/semesters`

## Request

- Base URL: `https://api.momence.com`
- URL: `https://api.momence.com/api/v2/host/semesters`
- Auth: OAuth 2
  - Authorization code: `/api/v2/auth/authorize`
  - Password
  - Token URL: `/api/v2/auth/token`

A semester groups a recurring set of classes that customers enrol into as a whole. 
 
The `id` returned here is the stable identifier of the group. Individual classes report it as `semesterId` on `GET /api/v2/host/sessions`, so the two endpoints can be joined to attribute a class - or a sale made against one - to the semester it belongs to. 
 
`activeFrom` and `activeTo` filter on overlap, not containment: a semester running January to June is returned for `activeFrom=2021-03-01&activeTo=2021-03-31`.

## Query parameters

- `page` integer, required
- `pageSize` integer, required
- `sortOrder` 'ASC' | 'DESC'
- `sortBy` 'startsAt' | 'endsAt' | 'name'
- `activeFrom` string, date-time
- `activeTo` string, date-time
- `includeCancelled` boolean
- `includeDrafts` boolean

## Response `200`

- object
  - `pagination` PaginatedResponseDataDto, required
    - `page` integer, required
    - `pageSize` integer, required
    - `totalCount` integer, required
    - `sortBy` string
    - `sortOrder` 'ASC' | 'DESC'
  - `payload` HostSemesterDto[], required
    - `id` integer, required: Stable identifier of the semester, shared with the semester parent session. Classes belonging to this semester report it as `semesterId`.
    - `name` string, required
    - `startsAt` string, date-time, required: Start of the semester date range, at the beginning of the day in the host time zone. This is the enrolment window boundary, not the time of the first class. `GET /api/v2/host/sessions/{sessionId}` reports a different `startsAt` for the same id, shifted to the first weekly slot.
    - `endsAt` string, date-time, required: End of the semester date range, at the end of the day in the host time zone.
    - `isDraft` boolean, required
    - `isCancelled` boolean, required

## Changes

- **2026-11-03** `5adb9a85439b`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/momence/apis/momence-public/changes/api/v2/host/semesters/get.md)

---

[API](https://skmtc.dev/momence/apis/momence-public.md) - [All operations](https://skmtc.dev/momence/apis/momence-public/llms.txt) - [OpenAPI document](https://skmtc.dev/momence/apis/momence-public/revisions/5adb9a85439b?raw)
