---
title: "Search upcoming class sessions"
method: GET
path: "/api/v1/classes"
tags: ["Public API v1"]
---

# Search upcoming class sessions

`GET /api/v1/classes`

## Request

- Base URL: `https://movementors.com`
- URL: `https://movementors.com/api/v1/classes`
- Auth: none declared

One row per upcoming session, so a weekly class appears once per date.

## Query parameters

- `q` string: Free-text search.
- `city` string: City slug, e.g. costa-mesa-us.
- `category` string: Discipline slug, e.g. pilates.
- `page` integer
- `limit` integer: Default 20, max 50.
- `type` 'PRIVATE' | 'GROUP'
- `format` 'online' | 'in_person'
- `kind` 'CLASS' | 'EVENT' | 'RETREAT': Default CLASS.
- `dateFrom` string: YYYY-MM-DD, inclusive.
- `dateTo` string: YYYY-MM-DD, inclusive.
- `lang` string: Teaching language code, e.g. en.
- `teacher` string: Mentor slug.
- `locale` 'en' | 'es' | 'pt' | 'de' | 'fr' | 'it' | 'nl': Language for discipline names. Default en.

## Response `200`

One page of sessions

- object
  - `classes` unknown[], required
    - unknown
  - `pagination` object, required
    - `page` integer, required
    - `limit` integer, required
    - `total` integer, required
    - `totalPages` integer, required

## Other responses

- `400`: Invalid query parameter (code invalid_parameter)
- `404`: No such resource (code not_found)
- `405`: Write method on a read-only endpoint (code method_not_allowed)
- `429`: Rate limited (code rate_limited). Wait Retry-After seconds.
- `500`: Server error (code internal_error). Retry with backoff.

---

[API](https://skmtc.dev/movementors/apis/movementors-api.md) · [All operations](https://skmtc.dev/movementors/apis/movementors-api/llms.txt) · [OpenAPI document](https://skmtc.dev/movementors/apis/movementors-api/revisions/042fb6b44679?raw)