---
title: "Get School Analytics"
method: GET
path: "/admin/schools/{school_id}/analytics"
tags: ["Admin - Schools"]
---

# Get School Analytics

`GET /admin/schools/{school_id}/analytics`

Get comprehensive analytics for a school including all teachers and classes.
Aggregates data from all teachers belonging to this school.
Only accessible by admin users.

## Path parameters

- `school_id` string, required — The ID of the school

## Query parameters

- `weeks` integer

## Response `200`

Successful Response

- SchoolAnalyticsResponse — Complete analytics response for a school
  - `school_id` string, required
  - `school_name` string, required
  - `school_domain` string, nullable
  - `total_teachers` integer, required
  - `total_classes` integer, required
  - `total_students` integer, required
  - `total_exercises_completed` integer, required
  - `total_homework_exercises` integer, required
  - `total_teacher_exams` integer, required
  - `total_courses` integer, required
  - `total_teacher_assignments` integer, required
  - `total_chat_words` integer, required
  - `total_time_spent_hours` number, required
  - `active_students_last_month` integer, required
  - `weekly_activity` object, required
  - `weekly_homework_activity` object, required
  - `teachers` SchoolTeacherAnalytics[], required
    - `teacher_id` string, required
    - `teacher_name` string, required
    - `teacher_email` string, required
    - `total_classes` integer, required
    - `total_students` integer, required
    - `total_exercises_completed` integer, required
    - `total_homework_exercises` integer, required
    - `total_teacher_exams` integer, required
    - `total_courses` integer, required
    - `total_teacher_assignments` integer, required
    - `total_chat_words` integer, required
    - `total_time_spent_hours` number, required
    - `active_students_last_month` integer, required
    - `segments` string[]
    - `weekly_activity` object, required
    - `weekly_homework_activity` object, required
  - `classes` SchoolClassAnalytics[], required
    - `class_id` string, required
    - `class_name` string, required
    - `teacher_name` string, required
    - `total_students` integer, required
    - `active_students_last_month` integer, required
    - `total_exercises_completed` integer, required
    - `total_homework_exercises` integer, required
    - `total_chat_words` integer, required
    - `total_time_spent_hours` number, required
    - `weekly_activity` object, required
    - `weekly_homework_activity` object, required
  - `weeks_analyzed` integer, required
  - `analysis_start_date` string, date-time, required
  - `analysis_end_date` string, date-time, required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-02** `8d495ed916c6` — 2 breaking
  - the response property `school_domain` became optional for the status `200`
  - response property `school_domain` list-of-types was widened by adding types `null` to media type `application/json` of response `200`

[Change history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/admin/schools/:school_id/analytics/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-service-production.skmtc.workers.dev/v1/apis/excellence-ai/excellence-learning/revisions/8d495ed916c6/schema)