---
search:
  tags:
    - Study programs
    - GET
seo:
  description: >-
    Returns a cursor-paginated list of study programs. Each item includes
    program versions,… Reference for the GET /study-programs endpoint in the
    Fuxam API v4.
sidebar:
  label: List study programs
  badge: GET
title: List study programs
type: openapi-operation
---
Returns a cursor-paginated list of study programs. Each item includes program versions, responsible users, connected curricula, and summary counts. Use GET /cohorts?studyProgramId={id} for cohort details. Scoped to your integration's institution via Basic Auth credentials.

`GET /study-programs`

**Responses**

- `200` — List of study programs
- `401` — Unauthorized
- `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": "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"
  }
}
```