GET /api/v1/student/{studentId}/cats/{catId}/preview

Retrieves minimal CAT metadata for preview before starting an attempt. Questions are not included.

Path parameters

  • studentId string Required

    Unique identifier of the student

  • catId string Required

    Unique identifier of the CAT

Responses

  • 200 application/json

    CAT preview retrieved successfully

  • 400

    Cannot access CAT preview (not enrolled, invalid status)

  • 404

    Student or CAT not found

GET /api/v1/student/{studentId}/cats/{catId}/preview
curl \
 --request GET 'https://api.echoplain.social/api/v1/student/uuid-string/cats/uuid-string/preview'
Response examples (200)
{
  "cat": {
    "id": "uuid",
    "score": 30,
    "title": "CAT 1",
    "status": "ACTIVE",
    "dueDate": "2025-10-01T01:00:00.000Z",
    "maxAttempts": 1,
    "releaseDate": "2025-10-01T00:00:00.000Z",
    "attemptsUsed": 0,
    "durationMinutes": 60
  },
  "message": "CAT preview retrieved successfully",
  "success": true,
  "canAttempt": true
}