---
title: "Report Admin analytics overview"
method: GET
path: "/Reports/Admin/Analytics"
tags: ["Reports"]
---

# Report Admin analytics overview

`GET /Reports/Admin/Analytics`

**Requires permissions:** *MusicAdmins* or *ReportAdmins*

Aggregate completion and AI-usage statistics across active reports for an academic year, broken down overall, per report and per step. Built from a small fixed number of projected GROUP BY queries (no N+1).

## Query parameters

- `academicYear` integer, nullable
- `music` boolean, nullable

## Response `200`

Success - analytics overview

- GetReportAnalyticsResponse
  - `academicYear` integer
  - `overall` GetReportAnalyticsAnalyticsTotals
    - `totalEntries` integer
    - `complete` integer
    - `incomplete` integer
    - `completePct` integer
    - `aiAssisted` integer
    - `aiNotUsed` integer
    - `aiUntouched` integer
  - `reports` GetReportAnalyticsReportAnalyticsDto[]
    - `totalEntries` integer
    - `complete` integer
    - `incomplete` integer
    - `completePct` integer
    - `aiAssisted` integer
    - `aiNotUsed` integer
    - `aiUntouched` integer
    - `reportId` integer
    - `name` string, nullable
    - `academicYear` integer
    - `yearGroup` string, nullable
    - `publishedDate` string, date-time, nullable
    - `steps` GetReportAnalyticsStepAnalyticsDto[]
      - `totalEntries` integer
      - `complete` integer
      - `incomplete` integer
      - `completePct` integer
      - `aiAssisted` integer
      - `aiNotUsed` integer
      - `aiUntouched` integer
      - `stepId` integer
      - `number` integer
      - `name` string, nullable
      - `openDate` string, date-time, nullable
      - `closeDate` string, date-time, nullable
      - `state` string
      - `enableAiChecker` boolean
    - `subjects` GetReportAnalyticsSubjectAnalyticsDto[]
      - `totalEntries` integer
      - `complete` integer
      - `incomplete` integer
      - `completePct` integer
      - `aiAssisted` integer
      - `aiNotUsed` integer
      - `aiUntouched` integer
      - `name` string

## Other responses

- `400` — An Error Occurred - could not build analytics
- `401` — Unauthorized
- `403` — Forbidden

---

[API](https://skmtc.net/tonbridge/apis/tonbridge-app-api.md) · [All operations](https://skmtc.net/tonbridge/apis/tonbridge-app-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/tonbridge/tonbridge-app-api/versions/28344aa564b4/schema)