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

Base URLCustom base URLOverrides the selected server when set.

Authorization

Basic auth usernameBasic auth password

Remember on this deviceInclude my values in samples

Parameters

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

Request

curl -X GET 'https://fuxam.app/api/v4/study-programs' \
  -H 'Authorization: Basic YOUR_CREDENTIALS'

const response = await fetch("https://fuxam.app/api/v4/study-programs", {
  method: "GET",
  headers: {
    "Authorization": "Basic YOUR_CREDENTIALS"
  }
});

import requests

response = requests.get(
    "https://fuxam.app/api/v4/study-programs",
    headers={
        "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"
  }
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}

{
  "type": "error",
  "code": "resource_not_found",
  "title": "Not Found",
  "status": 404,
  "detail": "Course not found",
  "instance": "req_1234567890_abc",
  "errors": [
    {
      "field": "string",
      "message": "string"
    }
  ]
}