---
title: "Lists all exams of the school"
method: GET
path: "/v1/exams"
tags: ["exams"]
---

# Lists all exams of the school

`GET /v1/exams`

## Request

- Base URL: `https://api.memberspot.de` (the document declares no server; this is the origin it was published from)
- URL: `https://api.memberspot.de/v1/exams`
- Auth: API key in header `X-API-KEY`

## Response `200`

Returns all exams with their examId, name and number of questions

- ExamListResult
  - `data` ExamSummaryDto[], required: Array with all exams of the school
    - `examId` string, required: Exam identifier. Use it for GET /v1/exams/{id}/results to load the results of this exam.
    - `name` string, required: Exam name
    - `description` string: Exam description
    - `requiredPercentage` number: Percentage of points required to pass the exam
    - `questionCount` number, required: Number of questions in the exam
    - `created` string, date-time: Date the exam was created

## Other responses

- `400`: Missing arguments (check your api key)
- `401`: API key provided but invalid

---

[API](https://skmtc.dev/memberspot/apis/memberspot-api.md) · [All operations](https://skmtc.dev/memberspot/apis/memberspot-api/llms.txt) · [OpenAPI document](https://skmtc.dev/memberspot/apis/memberspot-api/revisions/48a9411d4339?raw)