---
title: "List Exams"
method: GET
path: "/v1/installs/{installSid}/courses/{courseSid}/exams"
tags: ["Exam"]
---

# List Exams

`GET /v1/installs/{installSid}/courses/{courseSid}/exams`

## Request

- Base URL: `https://api.smarterproctoring.com`
- URL: `https://api.smarterproctoring.com/v1/installs/{installSid}/courses/{courseSid}/exams`
- Auth: API key in header `token`

Returns a paginated list of exams belonging to the specified course.<br/><br/>Supports filtering with `includeStatusSummary` to include enrollment status counts per exam.<br/><br/>Supports sorting by `title`, `examOpenDate`, or `scheduleOpenDate`.

## Path parameters

- `installSid` string, required: Unique SID of the application install. Pattern: `AI` + 32 hex chars.
- `courseSid` string, required: Unique SID of the course. Pattern: `CU` + 32 hex chars.

## Query parameters

- `offset` integer: Zero-based offset for pagination.
- `limit` integer: Maximum number of exam records to return.
- `includeStatusSummary` boolean: When true, includes a summary of enrollment statuses (e.g., scheduled, completed, not started) for each exam.
- `excludeReadinessExams` boolean: When true, excludes readiness exams from the results. Defaults to `true`.
- `sortKeys` string[]: Array of field names to sort by. Valid values: `title`, `examOpenDate`, `scheduleOpenDate`.
- `sortOrder` 'ASC' | 'DESC': Sort direction. `ASC` for ascending or `DESC` for descending.
- `dob` string, date: Date of birth filter (internal use).

## Response `default`

Successful

- string

## Changes

- **2026-11-02** `8215e972c639`: 1 info
  - added the new optional `query` request parameter `excludeReadinessExams`

[Operation history](https://skmtc.dev/smarterproctoring/apis/smarterproctoring-api/changes/v1/installs/:installSid/courses/:courseSid/exams/get.md)

---

[API](https://skmtc.dev/smarterproctoring/apis/smarterproctoring-api.md) - [All operations](https://skmtc.dev/smarterproctoring/apis/smarterproctoring-api/llms.txt) - [OpenAPI document](https://skmtc.dev/smarterproctoring/apis/smarterproctoring-api/revisions/8215e972c639?raw)