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

# Returns a list of sessions

`GET /api/v2/host/sessions`

## Request

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

## Query parameters

- `page` integer, required
- `pageSize` integer, required
- `sortOrder` 'ASC' | 'DESC'
- `sortBy` 'name' | 'startsAt' | 'endsAt'
- `includeCancelled` boolean
- `types` string[]
- `teacherId` integer
- `locationId` integer
- `includeChildLocations` boolean
- `startAfter` string
- `startBefore` string
- `endAfter` string
- `endBefore` string

## Response `200`

- object
  - `pagination` PaginatedResponseDataDto, required
    - `page` integer, required
    - `pageSize` integer, required
    - `totalCount` integer, required
    - `sortBy` string
    - `sortOrder` 'ASC' | 'DESC'
  - `payload` HostSessionDto[], required
    - `id` integer, required
    - `name` string, required
    - `type` 'private' | 'special-event' | 'special-event-new' | 'retreat' | 'fitness' | 'course' | 'course-class' | 'semester' | 'recital', required
    - `semesterId` integer, nullable, required: Id of the semester this class belongs to, or null when it does not belong to one. A semester itself reports null here - its own id is in `id` and its `type` is `semester`. Resolve it with GET /api/v2/host/semesters.
    - `description` string, nullable, required
    - `startsAt` string, date-time, required
    - `endsAt` string, date-time, required
    - `durationInMinutes` integer, required
    - `capacity` integer, nullable, required
    - `bookingCount` integer, required
    - `teacher` MemberTeacherDto, nullable, required
      - `id` integer, required
      - `firstName` string, required
      - `lastName` string, required
      - `pictureUrl` string, nullable, required
    - `isRecurring` boolean, required
    - `isCancelled` boolean, required
    - `isInPerson` boolean, required
    - `isDraft` boolean, required
    - `inPersonLocation` MemberLocationDto, nullable, required
      - `id` integer, required
      - `name` string, required
    - `onlineStreamUrl` string, nullable, required
    - `onlineStreamPassword` string, nullable, required
    - `bannerImageUrl` string, nullable, required
    - `hostPhotoUrl` string, nullable, required
    - `tags` SessionTagDto[]
      - `id` integer, required
      - `name` string, required
      - `isCustomerBadge` boolean, required
      - `badgeLabel` string, nullable, required
      - `badgeColor` string, nullable, required

## Changes

- **2026-11-03** `5adb9a85439b`: 1 info
  - added the required property `allOf[subschema #2]/payload/items/semesterId` to the response with the `200` status

[Operation history](https://skmtc.dev/momence/apis/momence-public/changes/api/v2/host/sessions/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)
