---
title: "Get a list of folders to a specific path."
method: GET
path: "/dataset/browse"
tags: ["dataset"]
---

# Get a list of folders to a specific path.

`GET /dataset/browse`

Retrieve the folder structure of the given path.

## Query parameters

- `path` string, required — Path of the folder you want to browse.
- `page` integer — Page number for pagination.
- `pageSize` integer — Number of transfers per page.

## Response `200`

List of folders successfully retrieved.

- GetBrowseDatasetResponse
  - `folders` FolderNode[], required
    - `name` string, required
    - `path` string, required
    - `children` boolean, required
    - `probablyDataset` boolean, required
  - `total` integer, required — Total number of folders.

## Other responses

- `400` — Invalid request
- `401` — Unauthorized access: the path is not allowed for the user, or the user is not logged in
- `500` — Internal server error

## Changes

> 50 revisions in range; 3 not diffed.

- **2025-08-15** `effe6597c391` — 2 info
  - added the non-success response with the status `401`
  - added the non-success response with the status `500`
- **2025-03-06** `5ae2817840d4` — 2 info
  - the response property `folders` became required for the status `200`
  - the response property `total` became required for the status `200`
- **2025-03-06** `af09403d2e7f` — 1 info
  - added the required property `folders/items/path` to the response with the `200` status
- **2025-03-03** `e226c2e0da48` — 1 breaking, 2 info
  - removed the required property `folders/items/path` from the response with the `200` status
  - api operation id `FilesystemController_browseFilesystem` removed and replaced with `DatasetController_browseFilesystem`
  - the response property `folders/items/probablyDataset` became required for the status `200`
- **2025-02-27** `e573478f5cda` — 1 info
  - endpoint added

[Change history](https://skmtc.dev/swissopenem/apis/scicat-ingestor-api/changes/dataset/browse/get.md)

---

[API](https://skmtc.dev/swissopenem/apis/scicat-ingestor-api.md) · [All operations](https://skmtc.dev/swissopenem/apis/scicat-ingestor-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/swissopenem/scicat-ingestor-api/revisions/f35bb454d121/schema)