---
title: "Get Class Overview"
method: GET
path: "/teacher/classes/{class_id}/dashboard/overview"
tags: ["class_dashboard"]
---

# Get Class Overview

`GET /teacher/classes/{class_id}/dashboard/overview`

Moyenne générale, médiane, and the five most recent activities.

Read WITHIN the period, unlike the mastery endpoint: "what did we do this
trimester" means the trimester.

## Path parameters

- `class_id` string, required

## Query parameters

- `period` string, nullable — Selected period: t1 / t2 / t3 / this_week / this_month / vacances_ete / school_year. An unrecognised value falls back to the full school year rather than erroring, so a stale bookmark still renders.

## Response `200`

Successful Response

- ClassOverviewResponse — `weights` carries the coefficients so the frontend can render the "évaluations ×4, DM ×1, C.C. ×½" tooltip from the same constant the average was computed with, instead of restating the formula in French in a component. It is not there for the client to recompute anything.
  - `class_name` string, required
  - `period` string, required
  - `total_students` integer, required
  - `general_average` number, nullable
  - `general_median` number, nullable
  - `recent` RecentActivityResponse[], required
    - `activity_id` string, required
    - `activity_type` 'evaluation' | 'devoir' | 'cours' | 'controle', required
    - `title` string, required
    - `occurred_at` string, date-time, required
    - `starts_at` string, date-time, nullable
    - `ends_at` string, date-time, nullable
    - `target_id` string, nullable
    - `class_average` number, nullable
    - `reference_average` number, nullable
    - `trend` string, nullable
    - `completed_count` integer, required
    - `total_students` integer, required
  - `weights` object, required

## Other responses

- `400` — Malformed identifier
- `403` — Not authorized for this resource
- `404` — Resource not found
- `422` — Validation Error

---

[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-service-production.skmtc.workers.dev/v1/apis/excellence-ai/excellence-learning/revisions/ef67479ed898/schema)