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

# Get School Usage

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

Usage tab: students and teachers of the school over the period. A term
that has not started yet answers 409.

## Path parameters

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

## Query parameters

- `period` 'last_30_days' | 't1' | 't2' | 't3' | 'year' | 'previous_year'
- `subject` 'all' | 'maths' | 'physique-chimie'

## Response `200`

Successful Response

- SchoolUsageResponse
  - `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
  - `subject` 'all' | 'maths' | 'physique-chimie', required
  - `students` StudentUsageResponse, required
    - `enrolled` integer, required
    - `pending` integer, required
    - `active` integer, required
    - `active_rate` number, nullable, required
    - `active_rate_with_pending` number, nullable, required
    - `goal` integer, required
    - `autonomy` StudentAutonomyResponse, required
      - `trainings` integer, required
      - `students_training` integer, required
      - `homework_help` integer, required
      - `students_homework_help` integer, required
      - `exercises_per_student` number, nullable, required
      - `students_working_alone` integer, required
      - `share_of_active` number, nullable, required
    - `with_teacher` StudentWithTeacherResponse, required
      - `homework_submitted` integer, required
      - `homework_expected` integer, required
      - `students_who_submitted` integer, required
      - `share_of_enrolled` number, nullable, required
      - `copies_corrected` integer, required
      - `evaluations_corrected` integer, required
      - `courses_given` integer, required
      - `courses_viewed` integer, nullable, required
      - `students_who_viewed_courses` integer, nullable, required
    - `weekly` WeeklyConnectionsResponse[], required
      - `week_start` string, date, required
      - `iso_week` integer, required
      - `connected` integer, required
      - `is_current` boolean, required
  - `teachers` TeacherUsageResponse, required
    - `registered` integer, required
    - `active` integer, required
    - `active_rate` number, nullable, required
    - `goal` integer, required
    - `by_subject` SubjectHeadcountResponse[], required
      - `subject` 'maths' | 'physique-chimie', required
      - `registered` integer, required
      - `active` integer, required
    - `without_connection_30d` integer, required
    - `production` TeacherProductionResponse, required
      - `classes` ContributedCountResponse, required
        - `total` integer, required
        - `teachers` integer, required
      - `exercises_created` ContributedCountResponse, required
        - `total` integer, required
        - `teachers` integer, required
      - `assignments_given` ContributedCountResponse, required
        - `total` integer, required
        - `teachers` integer, required
      - `evaluations_created` ContributedCountResponse, required
        - `total` integer, required
        - `teachers` integer, required
      - `courses_created` ContributedCountResponse, required
        - `total` integer, required
        - `teachers` integer, required
      - `copies_corrected` CopiesCountResponse, required
        - `total` integer, required
        - `teachers` integer, required
        - `evaluations` integer, required
    - `weekly` WeeklyConnectionsResponse[], required
      - `week_start` string, date, required
      - `iso_week` integer, required
      - `connected` integer, required
      - `is_current` boolean, required
    - `subject_comparison` object, 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/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)