---
search:
  tags:
    - Modules
    - GET
seo:
  description: >-
    Returns a module with all versions fully expanded (examination requirements,
    time plan… Reference for the GET /modules/{id} endpoint in the Fuxam API v4.
sidebar:
  label: Get a module
  badge: GET
title: Get a module
type: openapi-operation
---
Returns a module with all versions fully expanded (examination requirements, time plan items, files, course connections, tags). Scoped to your integration's institution via Basic Auth credentials.

`GET /modules/{id}`

**Responses**

- `200` — Module
- `401` — Unauthorized
- `404` — Not Found
- `422` — Unprocessable Entity — validation or business rule error
- `429` — Too Many Requests — 1000 requests per minute per institution. Includes \`X-RateLimit-Limit\`, \`X-RateLimit-Remaining\`, \`X-RateLimit-Reset\` (ISO-8601), and \`Retry-After\` (seconds).
- `500` — Internal Server Error

Response example, 200:

```json
{
  "data": {
    "id": "cm_xyz789",
    "name": "Economics",
    "institutionId": "inst_123",
    "code": "ECO-101",
    "isArchived": false,
    "nameTranslations": null,
    "isSubmodule": false,
    "courseModuleTags": [
      {
        "id": "cmt_abc123",
        "courseModuleId": "cm_xyz789",
        "tagId": "tag_def456",
        "tag": {
          "id": "tag_def456",
          "name": "Core Module",
          "institutionId": "inst_123",
          "color": "#0361fc",
          "icon": "book"
        }
      }
    ],
    "versions": [
      {
        "id": "cmv_abc123",
        "version": "1.0.0",
        "name": "Introduction to Economics",
        "description": "Introductory economics module.",
        "icon": "📚",
        "iconType": "emoji",
        "banner": null,
        "createdAt": "2026-01-15T10:00:00.000Z",
        "updatedAt": "2026-06-01T08:30:00.000Z",
        "requiredAttendancePercentage": 80,
        "ectsPoints": 5,
        "courseModuleId": "cm_xyz789",
        "status": "ACTIVE",
        "timePlanId": "ilu_001",
        "isDefault": true,
        "earlyAssessmentEnabled": false,
        "isCurrentlyElectable": true,
        "capacity": 30,
        "color": null,
        "courseChatFileAttachmentsDefault": true,
        "courseChatReadOnlyDefault": false,
        "courseFeatureDefaults": null,
        "moduleName": "Economics 101",
        "attemptRules": null,
        "createdCourses": [
          {
            "id": "course_001",
            "layer_id": "layer_001",
            "name": "Introduction to Economics",
            "icon": "/illustrations/course-icon-library/book-worm.webp",
            "color": 5,
            "dynamicBanner": null,
            "institution_id": "inst_123",
            "description": null,
            "bannerImage": null,
            "iconType": "image",
            "courseModuleVersionId": "cmv_abc123",
            "curriculaId": null,
            "code": "ECO-101",
            "capacity": null,
            "status": "ACTIVE",
            "isDatabase": false,
            "settings": null,
            "learningJourneyMode": "DEFAULT",
            "scormFileUrl": null,
            "scormR2FileUrl": null,
            "scormProcessingProgress": null,
            "scormProcessingStage": null,
            "scormProcessingStatus": null
          }
        ],
        "timePlan": {
          "id": "ilu_001",
          "name": "UE",
          "institutionId": "inst_123",
          "minutes": 45,
          "isDefault": false
        },
        "parentConnections": [
          {
            "id": "conn_002",
            "parentModuleVersionId": "cmv_abc123",
            "childModuleVersionId": "cmv_child",
            "studyPeriodId": "cvt_001",
            "childModuleVersion": {
              "id": "cmv_child",
              "version": "2.0.0",
              "name": "Follow-up Module",
              "description": null,
              "icon": null,
              "iconType": "emoji",
              "banner": null,
              "createdAt": "2026-01-15T10:00:00.000Z",
              "updatedAt": "2026-06-01T08:30:00.000Z",
              "requiredAttendancePercentage": 80,
              "ectsPoints": 5,
              "courseModuleId": "cm_followup",
              "status": "ACTIVE",
              "timePlanId": null,
              "isDefault": false,
              "earlyAssessmentEnabled": false,
              "isCurrentlyElectable": true,
              "capacity": null,
              "color": null,
              "courseChatFileAttachmentsDefault": true,
              "courseChatReadOnlyDefault": false,
              "courseFeatureDefaults": null,
              "moduleName": null,
              "attemptRules": null
            }
          }
        ],
        "childConnections": [
          {
            "id": "conn_001",
            "parentModuleVersionId": "cmv_parent",
            "childModuleVersionId": "cmv_abc123",
            "studyPeriodId": "cvt_001",
            "parentModuleVersion": {
              "id": "cmv_parent",
              "version": "1.0.0",
              "name": "Prerequisite Module",
              "description": null,
              "icon": null,
              "iconType": "emoji",
              "banner": null,
              "createdAt": "2026-01-01T10:00:00.000Z",
              "updatedAt": "2026-06-01T08:30:00.000Z",
              "requiredAttendancePercentage": 80,
              "ectsPoints": 5,
              "courseModuleId": "cm_prereq",
              "status": "ACTIVE",
              "timePlanId": null,
              "isDefault": true,
              "earlyAssessmentEnabled": false,
              "isCurrentlyElectable": true,
              "capacity": null,
              "color": null,
              "courseChatFileAttachmentsDefault": true,
              "courseChatReadOnlyDefault": false,
              "courseFeatureDefaults": null,
              "moduleName": null,
              "attemptRules": null
            }
          }
        ],
        "examinationRequirements": [
          {
            "id": "req_001",
            "courseModuleVersionId": "cmv_abc123",
            "name": "Final Exam",
            "nameEnglish": null,
            "type": "exam",
            "length": 120,
            "ratingMode": "PASSED_OR_FAILED",
            "schedulingMode": "DEADLINE",
            "isFinalExam": true,
            "weightPercentage": 100,
            "attemptWorkflow": "AUTO_REATTEMPT",
            "examinationRequirementTemplateId": "ert_001",
            "templateId": "ert_001",
            "allowAlternativeRequest": false,
            "needsTopicConfirmation": false,
            "topicSubmissionDaysBeforeDeadline": null,
            "examineeAssignmentMode": "STANDARD",
            "customExamFormId": null,
            "nameTranslations": null,
            "examinationRequirementTemplate": null
          }
        ],
        "timePlanItems": [
          {
            "id": "tpi_001",
            "name": "Lecture",
            "needsAppointment": true,
            "amount": 14
          }
        ],
        "additionalDescriptions": [
          {
            "id": "desc_001",
            "name": "Learning Outcomes",
            "description": "Students will understand basic economics.",
            "position": 0
          }
        ],
        "files": [
          {
            "id": "file_001",
            "fileUrl": "https://storage.example.com/module.pdf"
          }
        ]
      }
    ]
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-06-26T00:00:00.000Z",
    "version": "v4"
  }
}
```