---
search:
  tags:
    - Modules
    - GET
seo:
  description: >-
    Returns a cursor-paginated catalog of Modules and Submodules. Omit kind to
    keep the unfiltered… Reference for the GET /modules endpoint in the Fuxam
    API v4.
sidebar:
  label: List modules
  badge: GET
title: List modules
type: openapi-operation
---
Returns a cursor-paginated catalog of Modules and Submodules. Omit `kind` to keep the unfiltered legacy list and pagination. `kind=module` returns `isSubmodule=false`. `kind=submodule` returns reusable catalog Submodules (`isSubmodule=true`) and requires Module Hierarchy; otherwise the API returns 409 Conflict. This is not the parent-version connection list — use GET /modules/{id}/versions/{versionId}/submodules for attached connections. Each item includes the latest version summary. Scoped to your integration's institution via Basic Auth credentials.

`GET /modules`

**Responses**

- `200` — List of modules
- `401` — Unauthorized
- `409` — Conflict — duplicate email or membership code (body includes \`existingUserId\` when known), a time-tracking session that is already running (\`activeSession\`), a time-tracking interval that overlaps an existing log (\`conflictingLog\`), idempotency key reused with a different body (\`idempotency\_key\_reused\`), or concurrent request with the same key still in progress (\`idempotency\_key\_in\_progress\`)
- `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": "cmqevazrw05p34pi9wv9w3mks",
      "name": "Business Administration",
      "institutionId": "inst_123",
      "code": "BA-101",
      "isArchived": false,
      "nameTranslations": null,
      "isSubmodule": false,
      "versions": [
        {
          "id": "cmqevazu005pb4pi9zp2zthd1",
          "version": "2.0.0",
          "name": "Business Administration Basics",
          "description": "",
          "icon": null,
          "iconType": "emoji",
          "banner": null,
          "createdAt": "2026-06-15T07:04:18.408Z",
          "updatedAt": "2026-06-15T07:04:18.408Z",
          "requiredAttendancePercentage": 80,
          "ectsPoints": 5,
          "courseModuleId": "cmqevazrw05p34pi9wv9w3mks",
          "status": "ACTIVE",
          "timePlanId": "cmqevazr905p14pi9st41ex1w",
          "isDefault": false,
          "earlyAssessmentEnabled": false,
          "isCurrentlyElectable": true,
          "capacity": null,
          "color": null,
          "courseChatFileAttachmentsDefault": true,
          "courseChatReadOnlyDefault": false,
          "courseFeatureDefaults": null,
          "moduleName": null,
          "attemptRules": null
        }
      ]
    }
  ],
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "limit": 10
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-06-26T00:00:00.000Z",
    "version": "v4"
  }
}
```