---
title: "Get Folder Contents"
method: GET
path: "/folders/{folder_id}/contents"
tags: ["folders"]
---

# Get Folder Contents

`GET /folders/{folder_id}/contents`

List folders and items under a given folder, if the user has access.
Uses the centralized sharing service for access control.
Returns both child folders and items (exercises/exams) based on folder type.

## Path parameters

- `folder_id` string, required

## Response `200`

Successful Response

- ContentsResponse
  - `status` string, required
  - `access` object, required
  - `folder` object, nullable
  - `folders` object[], required
  - `items` object[], required

## Other responses

- `422` — Validation Error

## Changes

- **2026-09-07** `0ccba2913cca` — 1 info
  - added the optional property `folder` to the response with the `200` status

[Change history](https://skmtc.dev/excellence-ai/apis/excellence-learning/changes/folders/:folder_id/contents/get.md)

---

[API](https://skmtc.dev/excellence-ai/apis/excellence-learning.md) · [All operations](https://skmtc.dev/excellence-ai/apis/excellence-learning/llms.txt) · [OpenAPI document](https://skmtc.dev/excellence-ai/apis/excellence-learning/revisions/2a0c1636fd3b?raw)