GET /api/v1/exam/{id}

Retrieve detailed information about a specific exam including questions, settings, and metadata. Access level determines the amount of detail returned.

Path parameters

  • id string Required

    UUID of the exam

Query parameters

  • accessLevel string

    Access level for the request - HIGH for admin/lecturer (includes all details), NORMAL for students (limited view)

    Values are HIGH or NORMAL.

Responses

  • 200 application/json

    Exam details retrieved successfully

  • 400 application/json

    Default bad request error 400 response

    Hide response attributes Show response attributes object
    • message string Required

      Response message

    • error string Required
    • statusCode number Required
  • 401

    Unauthorized - JWT token required

  • 404

    Exam not found

GET /api/v1/exam/{id}
curl \
 --request GET 'https://api.echoplain.social/api/v1/exam/123e4567-e89b-12d3-a456-426614174000'
Response examples (200)
{
  "id": "123e4567-e89b-12d3-a456-426614174000",
  "title": "Midterm Exam - Data Structures",
  "status": "SCHEDULED",
  "endTime": "2025-11-20T11:00:00Z",
  "questions": [],
  "startTime": "2025-11-20T09:00:00Z",
  "totalMarks": 100,
  "description": "Comprehensive exam covering all topics in the first half of the semester",
  "passingMarks": 50,
  "durationMinutes": 120
}
Response examples (400)
{
  "message": "string",
  "error": "string",
  "statusCode": 42.0
}