---
title: "Get School Code Analytics"
method: GET
path: "/admin/school-codes/{code_id}/analytics"
tags: ["Admin - School Codes"]
---

# Get School Code Analytics

`GET /admin/school-codes/{code_id}/analytics`

Get detailed analytics for students who used a specific school code,
including their holiday course usage statistics.
Only accessible by admins.

## Path parameters

- `code_id` string, required

## Response `200`

Successful Response

- SchoolCodeAnalyticsResponse — Response model for school code analytics.
  - `school_code` SchoolCodeResponse, required — Response model for school code details.
    - `id` string, required
    - `code` string, required
    - `school_name` string, required
    - `description` string, nullable
    - `is_active` boolean, required
    - `max_uses` integer, nullable
    - `current_uses` integer, required
    - `created_by` string, required
    - `created_at` string, date-time, required
    - `updated_at` string, date-time, required
  - `total_students` integer, required
  - `avg_time_spent_hours` number, required
  - `avg_exercises_completed` number, required
  - `avg_completion_percentage` number, required
  - `students` StudentHolidayStatsResponse[], required
    - `student_id` string, required
    - `student_email` string, required
    - `student_name` string, nullable
    - `used_code_at` string, date-time, required
    - `total_time_spent_hours` number, required
    - `total_exercises_completed` integer, required
    - `total_exercise_attempts` integer, required
    - `completion_percentage` number, required
    - `progress_by_class` object[]
    - `last_activity_at` string, date-time, nullable

## Other responses

- `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/8d495ed916c6/schema)