Skip to content
Docs
English
EnglishDeutschNot translatedEspañolNot translated
Esc
↑↓navigate↵open⌘Jpreview

List study programs

Returns a cursor-paginated list of study programs. Each item includes program versions, responsible users, connected curricula, and summary counts. Use GET /study-programs/{id}/cohorts for cohort details. Scoped to your integration’s institution via Basic Auth credentials.

GET/study-programs
Authorization
AuthorizationBasic auth · headerrequired

Basic Auth with clientId as username and clientSecret as password

Query parameters
cursorstring
limitinteger
default: 10
searchstring
includeArchivedboolean

When false (default), archived study programs are excluded.

default: false
Responses
200

List of study programs

dataStudyProgram[]required
Show properties
Array of StudyProgram
idstringrequired
namestringrequired
institutionIdstringrequired
objectivestring | null
isArchivedbooleanrequired
codestring | null
statisticDataobject | null
defaultStudyTimeinteger
defaultTuitionFeePlanIdstring | null
hasCohortsbooleanrequired
hasStatisticsbooleanrequired
typestring | null
studyProgramVersionStudyProgramVersion[]required

Program versions (cohorts are listed separately).

Show properties
Array of StudyProgramVersion
idstringrequired
namestringrequired
institutionIdstringrequired
studyProgramIdstringrequired
isDefaultbooleanrequired
statisticDataobject | null
responsibleUsersSimpleUser[]required

studyProgramResponsibleUser[].user, sorted by name. The

Show properties
Array of SimpleUser
idstringrequired
namestringrequired
emailstring<email>required
imagestring | nullrequired
connectedCurriculaStudyProgramConnectedCurricula[]required

Flattened curricula from studyProgramConnectedCurricula (see StudyProgramConnectedCurricula). The

Show properties
Array of StudyProgramConnectedCurricula
idstringrequired
namestringrequired
institutionIdstringrequired
createdAtstring<date-time>required
updatedAtstring<date-time>required
isCohortSpecificbooleanrequired
isArchivedbooleanrequired
codestring | null
versionsCountintegerrequired
firstVersionobjectrequired

The first program version.

Show properties
idstringrequired
namestringrequired
institutionIdstringrequired
studyProgramIdstringrequired
isDefaultbooleanrequired
statisticDataobject | null
defaultVersionStudyProgramVersion | null

The default program version, if one is set.

Show properties
One of:
StudyProgramVersion
idstringrequired
namestringrequired
institutionIdstringrequired
studyProgramIdstringrequired
isDefaultbooleanrequired
statisticDataobject | null
null
null
versionsCountintegerrequired

Total number of program versions.

cohortsCountintegerrequired

Total cohort count across all versions.

studyProgramMetadataobject | nullrequired

Always null on list and detail responses; use version-specific endpoints for metadata.

paginationCursorPaginationrequired
Show properties
next_cursorstring | nullrequired
has_morebooleanrequired
limitintegerrequired
metaResponseMetarequired
Show properties
requestIdstringrequired
timestampstring<date-time>required
versionstringrequired
Allowed:v4
401

Unauthorized

typestringrequired
Allowed:error
codestringrequired
Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error
titlestringrequired
statusintegerrequired
detailstringrequired
instancestring
errorsobject[]
Show properties
Array of object
fieldstring
messagestring
429

Too Many Requests

typestringrequired
Allowed:error
codestringrequired
Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error
titlestringrequired
statusintegerrequired
detailstringrequired
instancestring
errorsobject[]
Show properties
Array of object
fieldstring
messagestring
500

Internal Server Error

typestringrequired
Allowed:error
codestringrequired
Allowed:bad_requestunauthorizedforbiddenresource_not_foundconflictvalidation_failedidempotency_key_reusedrate_limit_exceededinternal_error
titlestringrequired
statusintegerrequired
detailstringrequired
instancestring
errorsobject[]
Show properties
Array of object
fieldstring
messagestring
Try it
Server
Authorization
Parameters
Request
curl -X GET 'https://fuxam.app/api/v4/study-programs' \
  -H 'Authorization: Basic YOUR_CREDENTIALS'
Response
{
  "data": [
    {
      "id": "sp_abc123",
      "name": "Bachelor of Science",
      "institutionId": "inst_123",
      "objective": "Graduate competent professionals.",
      "isArchived": false,
      "code": "BSC-001",
      "statisticData": null,
      "defaultStudyTime": 6,
      "defaultTuitionFeePlanId": null,
      "hasCohorts": true,
      "hasStatistics": false,
      "type": "BACHELOR",
      "studyProgramVersion": [
        {
          "id": "spv_001",
          "name": "2024 Intake",
          "institutionId": "inst_123",
          "studyProgramId": "sp_abc123",
          "isDefault": true,
          "statisticData": null
        }
      ],
      "responsibleUsers": [
        {
          "id": "user_abc123",
          "name": "Jane Doe",
          "email": "jane@example.com",
          "image": null
        }
      ],
      "connectedCurricula": [
        {
          "id": "cur_001",
          "name": "Bachelor CS 2024",
          "institutionId": "inst_123",
          "createdAt": "2026-01-01T00:00:00.000Z",
          "updatedAt": "2026-06-01T00:00:00.000Z",
          "isCohortSpecific": false,
          "isArchived": false,
          "code": "CS-2024",
          "versionsCount": 2
        }
      ],
      "firstVersion": {
        "id": "spv_001",
        "name": "2024 Intake",
        "institutionId": "inst_123",
        "studyProgramId": "sp_abc123",
        "isDefault": true,
        "statisticData": null
      },
      "defaultVersion": {
        "id": "spv_001",
        "name": "2024 Intake",
        "institutionId": "inst_123",
        "studyProgramId": "sp_abc123",
        "isDefault": true,
        "statisticData": null
      },
      "versionsCount": 1,
      "cohortsCount": 1,
      "studyProgramMetadata": null
    }
  ],
  "pagination": {
    "next_cursor": null,
    "has_more": false,
    "limit": 10
  },
  "meta": {
    "requestId": "req_abc123",
    "timestamp": "2026-06-26T00:00:00.000Z",
    "version": "v4"
  }
}