---
title: "List Appointments Awaiting Audit"
method: GET
path: "/v1/installs/{installSid}/appointments/audit"
tags: ["Appointment"]
---

# List Appointments Awaiting Audit

`GET /v1/installs/{installSid}/appointments/audit`

## Request

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

Returns the appointments within the install that are waiting to be audited, along with the session, exam, course and user details.<br/><br/>An appointment is waiting to be audited when its exam has an `appointmentAuditLevel` of `approve` or `review` and the session does not yet have an `appointmentAuditStatus`.<br/><br/>Practice exams are excluded. Only active, non-cancelled sessions with an appointment date are returned, ordered by appointment date, oldest first.<br/><br/>Optionally filter by `courseSid` and/or `examSid`. Results are paginated and default to 50 per page.

## Path parameters

- `installSid` string, required: Install Sid

## Query parameters

- `courseSid` string: Only return appointments for exams in this course
- `examSid` string: Only return appointments for this exam
- `offset` integer: Result offset
- `limit` integer: Number of items to return

## Response `200`

Successful

- AppointmentAuditList
  - `total` number: Total number of results
  - `first` string, nullable: URL for first page
  - `next` string, nullable: URL for next page
  - `prev` string, nullable: URL for previous page
  - `last` string, nullable: URL for last page
  - `count` number: Number of results in this page
  - `offset` number: Current offset
  - `results` AppointmentAudit[]: Appointments awaiting audit
    - `sid` string, nullable: Exam session SID
    - `installSid` string, nullable: Install SID
    - `examSid` string, nullable: Exam SID
    - `courseSid` string, nullable: Course SID
    - `userSid` string, nullable: User SID
    - `enrollmentSid` string, nullable: Enrollment SID
    - `examConfigurationSid` string, nullable: Exam configuration SID
    - `status` string, nullable: Session status
    - `statusReason` string, nullable: Session status reason
    - `sessionType` string, nullable: Session type
    - `appointmentDate` string, nullable: Appointment date
    - `duration` number, nullable: Session duration in minutes
    - `dateScheduled` string, nullable: Date the session was scheduled
    - `dateApproved` string, nullable: Date the session was approved
    - `appointmentAuditStatus` string, nullable: Audit status of the appointment (null until audited)
    - `createdDate` string, nullable: Created date
    - `editDate` string, nullable: Edit date
    - `exam` AppointmentAuditExam, nullable: Exam the appointment is for
      - `sid` string, nullable: Exam SID
      - `title` string, nullable: Exam title
      - `type` string, nullable: Exam type
      - `status` string, nullable: Exam status
      - `examCode` string, nullable: Exam code
      - `appointmentAuditLevel` string, nullable: Level of audit required for appointments (approve or review)
    - `course` AppointmentAuditCourse, nullable: Course the exam belongs to
      - `sid` string, nullable: Course SID
      - `title` string, nullable: Course title
      - `code` string, nullable: Course code
    - `user` AppointmentAuditUser, nullable: User the appointment belongs to
      - `sid` string, nullable: User SID
      - `firstName` string, nullable: First name
      - `lastName` string, nullable: Last name
      - `email` string, nullable: Email
      - `lmsId` string, nullable: LMS ID
      - `sisId` string, nullable: SIS ID
      - `externalId` string, nullable: External ID
      - `timeZoneSid` string, nullable: Time zone SID

## Changes

- **2026-10-12** `da62d9723edd`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/smarterproctoring/apis/smarterproctoring-api/changes/v1/installs/:installSid/appointments/audit/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)