---
title: "List exams | Elenca esami"
method: GET
path: "/exams"
tags: ["Exams"]
---

# List exams | Elenca esami

`GET /exams`

## Request

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

## Response `200`

The request has succeeded.

- object
  - `data` Exam[], required
    - `id` integer, required
    - `courseId` number, required
    - `courseShortcode` string, required
    - `courseName` string, required
    - `teacherId` integer, required
    - `type` string, required
    - `places` PlaceRef[]
      - `buildingId` string, required
      - `floorId` string, required
      - `roomId` string, required
      - `siteId` string, required
      - `name` string, required
    - `status` 'available' | 'booked' | 'requestable' | 'requested' | 'requestAccepted' | 'requestRejected' | 'unavailable', required
    - `bookingStartsAt` string, date-time, nullable, required
    - `bookingEndsAt` string, date-time, required
    - `examStartsAt` string, date-time, nullable, required
    - `examEndsAt` string, date-time, nullable, required
    - `bookedCount` integer, required
    - `availableCount` integer, required
    - `question` object, nullable, required
      - `id` integer, required
      - `statement` string, required
      - `options` string[], required
    - `feedback` string, nullable, required
    - `isReschedulable` boolean, required: If true, the student can ask the professor to reschedule the exam
    - `notes` string, nullable, required
    - `moduleNumber` integer, required: The module number, if this is a module
    - `requestReason` string, nullable, required
    - `requestDetails` string, nullable, 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)