---
title: "Get School Classes Usage"
method: GET
path: "/admin/csm/schools/{school_id}/classes-usage"
tags: ["Admin - Suivi CSM"]
---

# Get School Classes Usage

`GET /admin/csm/schools/{school_id}/classes-usage`

Élèves tab: one row per class of the school year, sorted by name.

## Path parameters

- `school_id` string, required — The school's id

## Query parameters

- `period` 'last_30_days' | 't1' | 't2' | 't3' | 'year' | 'previous_year'

## Response `200`

Successful Response

- ClassUsageListResponse
  - `meta` UsageMetaResponse, required
    - `school_id` string, required
    - `school_name` string, required
    - `period` 'last_30_days' | 't1' | 't2' | 't3' | 'year' | 'previous_year', required
    - `school_year` string, required
    - `start` string, date-time, required
    - `end` string, date-time, required
    - `periods` PeriodAvailabilityResponse[], required
      - `key` 'last_30_days' | 't1' | 't2' | 't3' | 'year' | 'previous_year', required
      - `available` boolean, required
  - `classes` ClassUsageResponse[], required
    - `class_id` string, required
    - `name` string, required
    - `subject` 'maths' | 'physique-chimie', required
    - `grade` string, nullable, required
    - `segment` string, nullable, required
    - `teacher_id` string, required
    - `teacher_name` string, nullable, required
    - `enrolled` integer, required
    - `pending` integer, required
    - `active` integer, required
    - `active_rate` number, nullable, required
    - `trainings` integer, required
    - `homework_help` integer, required
    - `homework_submitted` integer, nullable, required
    - `homework_expected` integer, nullable, required
    - `evaluations_taken` integer, nullable, required
    - `courses_viewed` integer, nullable, required

## Other responses

- `400` — Malformed identifier
- `404` — Resource not found
- `409` — Business rule violated
- `422` — Validation Error

## Changes

> 33 revisions in range; 1 not diffed.

- **2026-10-06** `59dba414f8ae` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/admin/csm/schools/:school_id/classes-usage/get.md)

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) · [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) · [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/59dba414f8ae?raw)