--- search: tags: - Cohorts - GET seo: description: >- Returns cohort detail with computed status, a sample of members, total member count, and… Reference for the GET /cohorts/{id} endpoint in the Fuxam API v4. sidebar: label: Get a cohort badge: GET title: Get a cohort type: openapi-operation --- Returns cohort detail with computed status, a sample of members, total member count, and the linked curriculum version structure. Scoped to your integration's institution via Basic Auth credentials. `GET /cohorts/{id}` **Responses** - `200` — Cohort detail - `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": "coh_001", "name": "WS 2024/25", "startDate": "2024-10-01T00:00:00.000Z", "status": "ACTIVE", "endDate": "2027-09-30T00:00:00.000Z", "curriculaVersion": { "id": "cv_001", "version": "1.0", "name": "Default", "createdAt": "2026-01-01T00:00:00.000Z", "updatedAt": "2026-06-01T00:00:00.000Z", "curriculaId": "cur_001", "electionEndWeeks": null, "electionMode": null, "electionStartWeeks": null, "isCohortVersion": false, "sourceCohortId": null, "sourceCohort": null, "curriculaVersionTerms": [ { "id": "cvt_001", "position": 0, "name": "Semester 1", "curriculaVersionId": "cv_001", "cohortCurriculaVersionTerm": [ { "id": "ccvt_001", "curriculaVersionTermId": "cvt_001", "organizationTermId": "ot_001", "cohortId": "coh_001", "institutionId": "inst_123", "cohort": { "id": "coh_001", "name": "WS 2024/25" }, "organizationTerm": { "id": "ot_001", "name": "WS 2024/25", "termEnd": "2025-03-31T23:59:59.000Z", "institutionId": "inst_123", "termStart": "2024-10-01T00:00:00.000Z", "code": "WS24", "electionEnd": null, "electionStart": null, "reassessmentRegistrationEnd": null, "reassessmentRegistrationStart": null }, "curriculaVersionTerm": { "id": "cvt_001", "position": 0, "name": "Semester 1", "curriculaVersionId": "cv_001" }, "cohortStudyTimelineStatus": null } ] } ], "curriculaVersionPathways": [ { "id": "path_001", "position": 0, "name": "Software Engineering", "type": "SELECTABLE_FOCUS", "curriculaVersionId": "cv_001", "description": "Focus on software development." } ], "curriculaVersionModuleCluster": [ { "id": "cvmc_001", "electiveBehavior": "SELECT_UNTIL_ECTS", "electiveBehaviorAmount": 30, "rule": null, "ruleAmount": null, "createdAt": "2026-01-01T00:00:00.000Z", "updatedAt": "2026-06-01T00:00:00.000Z", "curriculaVersionId": "cv_001", "name": "Elective Pool", "unlockAfterCP": null, "electAtOnce": false, "overflowClusterId": null, "isReElectable": false } ], "isDefault": true, "curricula": { "id": "cur_001", "name": "Bachelor CS 2024", "isCohortSpecific": false }, "curriculaVersionItems": [ { "id": "cvi_001", "curriculaVersionId": "cv_001", "courseModuleId": "cm_xyz789", "courseModuleVersionId": "cmv_abc123", "curriculaVersionTermId": "cvt_001", "curriculaVersionModuleClusterId": null, "curriculaVersionPathwayId": "path_001", "parentId": null, "updatedAt": "2026-06-01T00:00:00.000Z", "isCoreModule": true, "courseModule": { "id": "cm_xyz789", "name": "Economics", "institutionId": "inst_123", "code": "ECO-101", "isArchived": false, "nameTranslations": null, "courseModuleTags": [ { "id": "cmt_abc123", "courseModuleId": "cm_xyz789", "tagId": "tag_def456", "tag": { "id": "tag_def456", "name": "Core Module", "institutionId": "inst_123", "color": "#0361fc", "icon": "book" } } ] }, "curriculaVersionTerm": { "id": "cvt_001", "position": 0, "name": "Semester 1", "curriculaVersionId": "cv_001", "cohortCurriculaVersionTerm": [ { "id": "ccvt_001", "curriculaVersionTermId": "cvt_001", "organizationTermId": "ot_001", "cohortId": "coh_001", "institutionId": "inst_123", "cohort": { "id": "coh_001", "name": "WS 2024/25" }, "organizationTerm": { "id": "ot_001", "name": "WS 2024/25", "termEnd": "2025-03-31T23:59:59.000Z", "institutionId": "inst_123", "termStart": "2024-10-01T00:00:00.000Z", "code": "WS24", "electionEnd": null, "electionStart": null, "reassessmentRegistrationEnd": null, "reassessmentRegistrationStart": null }, "curriculaVersionTerm": { "id": "cvt_001", "position": 0, "name": "Semester 1", "curriculaVersionId": "cv_001" }, "cohortStudyTimelineStatus": null } ] }, "curriculaVersionPathway": { "id": "path_001", "position": 0, "name": "Software Engineering", "type": "SELECTABLE_FOCUS", "curriculaVersionId": "cv_001", "description": "Focus on software development." }, "curriculaVersionModuleCluster": null, "moduleGroupId": null, "moduleGroup": null, "courseModuleVersion": { "examinationRequirements": [], "courseModuleId": "cm_xyz789", "id": "cmv_abc123", "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, "courseModule": { "id": "cm_prereq", "name": "Prerequisite Module", "institutionId": "inst_123", "code": "PRE-101", "isArchived": false, "nameTranslations": null } } } ], "name": "Introduction to Economics", "moduleName": "Economics 101", "version": "1.0.0", "ectsPoints": 5, "unitAmount": 14, "unitName": "UE", "unitMinuteEquivalent": 45 } } ] }, "curricula": { "id": "cur_001", "name": "Bachelor CS 2024", "isCohortSpecific": false }, "isArchived": false, "users": [ { "id": "user_abc123", "name": "Jane Doe", "email": "jane@example.com", "image": null } ], "totalUsersCount": 42, "hasDisconnectedFromCurricula": false }, "meta": { "requestId": "req_abc123", "timestamp": "2026-06-26T00:00:00.000Z", "version": "v4" } } ```