GET /api/v1/cats/unit/{unit}

Retrieves all CATs associated with a specific unit offering

Path parameters

  • unit string Required

    Unit offering ID

Query parameters

  • level string

    Access level - HIGH shows all CATs including drafts, NORMAL shows only released/active CATs

    Values are HIGH or NORMAL.

Responses

  • 200 application/json

    CATs 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
  • 404

    Unit not found or no CATs available

GET /api/v1/cats/unit/{unit}
curl \
 --request GET 'https://api.echoplain.social/api/v1/cats/unit/123e4567-e89b-12d3-a456-426614174000'
Response examples (200)
{
  "cats": [
    {
      "id": "123e4567-e89b-12d3-a456-426614174000",
      "marks": 30,
      "title": "Midterm CAT 1",
      "status": "RELEASED",
      "dueDate": "2025-10-15T11:00:00.000Z",
      "description": "First continuous assessment test",
      "releaseDate": "2025-10-15T09:00:00.000Z"
    }
  ],
  "total": 2,
  "message": "CATs found"
}
Response examples (400)
{
  "message": "string",
  "error": "string",
  "statusCode": 42.0
}