---
title: "Retrieve course statistics | Recupera le statistiche dell'insegnamento"
method: GET
path: "/offering/courses/{courseShortcode}/statistics"
tags: ["Offering"]
---

# Retrieve course statistics | Recupera le statistiche dell'insegnamento

`GET /offering/courses/{courseShortcode}/statistics`

## Request

- Base URL: `https://app.didattica.polito.it/api`
- URL: `https://app.didattica.polito.it/api/offering/courses/{courseShortcode}/statistics`
- Auth: HTTP bearer
- TypeScript: <https://skmtc.dev/polito/apis/polito-students-api/docs/offering/courses/:courseShortcode/statistics/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `courseShortcode` string, required

## Query parameters

- `year` string
- `teacherId` string

## Response `200`

The request has succeeded.

- object
  - `data` CourseStatistics, required
    - `shortcode` string, required
    - `year` integer, required
    - `teacher` Teacher, required
      - `id` integer, required
      - `firstName` string, required
      - `lastName` string, required
    - `totalEnrolled` integer, required
    - `totalSucceeded` integer, required
    - `totalFailed` integer, required
    - `firstYear` YearStatistics, required
      - `succeeded` integer, required
      - `failed` integer, required
      - `grades` GradeCount[], required
        - `grade` '18' | '19' | '20' | '21' | '22' | '23' | '24' | '25' | '26' | '27' | '28' | '29' | '30' | '30L', required
        - `count` integer, required
      - `averageGrade` number, nullable, required
    - `otherYears` YearStatistics, required
      - `succeeded` integer, required
      - `failed` integer, required
      - `grades` GradeCount[], required
        - `grade` '18' | '19' | '20' | '21' | '22' | '23' | '24' | '25' | '26' | '27' | '28' | '29' | '30' | '30L', required
        - `count` integer, required
      - `averageGrade` number, nullable, required
    - `previousYearsToCompare` PreviousYearsToCompare[], required
      - `year` integer, required
      - `succeeded` integer, required
      - `failed` integer, required
    - `years` integer[], required
    - `teachers` Teacher[], required
      - `id` integer, required
      - `firstName` string, required
      - `lastName` string, required

## Other responses

- `400`: The server could not understand the request due to invalid syntax.
- `500`: Server error

---

[API](https://skmtc.dev/polito/apis/polito-students-api.md) - [All operations](https://skmtc.dev/polito/apis/polito-students-api/llms.txt) - [OpenAPI document](https://skmtc.dev/polito/apis/polito-students-api/revisions/9d87728aaa56?raw)