---
title: "Retrieve student career | Recupera la cariera dello studente"
method: GET
path: "/student/career"
tags: ["Student"]
---

# Retrieve student career | Recupera la cariera dello studente

`GET /student/career`

## Request

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

## Response `200`

The request has succeeded.

- object
  - `data` StudentCareer, required
    - `state` Symbol, required
      - `label` string
      - `color` union
        - string
        - ThemeColors
          - `light` string, required: Color used in light mode.
          - `dark` string, required: Color used in dark mode.
      - `icon` string
    - `degreeId` string, required
    - `degreeCode` string, required
    - `degreeLevel` string, required
    - `degreeName` string, required
    - `firstEnrollmentYear` integer, required
    - `lastEnrollmentYear` integer, required
    - `isCurrentlyEnrolled` boolean, required
    - `averageGrade` number, nullable, required
    - `estimatedFinalGrade` number, nullable, required
    - `isFinalGradePurged` boolean, required: Specify whether estimatedFinelGrade is purged - Purged grade is only available for bachelor degree students
    - `mastersAdmissionAverageGrade` number, nullable, required: Master's admission grade is only available for bachelor degree students
    - `totalOnTimeExamPoints` number, nullable, required: Total points for "on-time" exams - null if "on-time" exams are not applicable for the student's position (max value = maxOnTimeExamPoints)
    - `maxOnTimeExamPoints` number, required: Maximum points for "on-time" exams
    - `excludedCreditsNumber` number, nullable, required: Credits excluded from calculating the purged grade
    - `totalCredits` integer, required
    - `totalAttendedCredits` integer, required
    - `totalAcquiredCredits` integer, required
    - `enrollmentCredits` integer, required
    - `enrollmentAttendedCredits` integer, required
    - `enrollmentAcquiredCredits` integer, required

## Other responses

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

## Changes

- **2026-09-22** `1f025f5deb2a`: 1 breaking, 1 info
  - removed the required property `data/status` from the response with the `200` status
  - added the required property `data/state` to the response with the `200` status
- **2026-06-17** `4ef98d007971`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/polito/apis/polito-students-api/changes/student/career/get.md)

---

[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)