---
title: "Get all folders."
method: GET
path: "/folders"
tags: ["folders"]
---

# Get all folders.

`GET /folders`

Returns all folders that the authenticated user has permission to view.
If nested folders are enabled, it expects an additional query parameter with the parent folder UID
and returns the immediate subfolders.

## Query parameters

- `limit` integer
- `page` integer
- `parentUid` string

## Response `200`

(empty)

- FolderSearchHit[]
  - `accessControl` Metadata — Metadata contains user accesses for a given resource Ex: map[string]bool{"create":true, "delete": true}
  - `id` integer
  - `parentUid` string
  - `title` string
  - `uid` string

## Other responses

- `401` — UnauthorizedError is returned when the request is not authenticated.
- `403` — ForbiddenError is returned if the user/token has insufficient permissions to access the requested resource.
- `500` — InternalServerError is a general error indicating something went wrong internally.

---

[API](https://skmtc.net/nforgeio/apis/grafana-http-api.md) · [All operations](https://skmtc.net/nforgeio/apis/grafana-http-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/nforgeio/grafana-http-api/revisions/3cb6c3f42dc7/schema)