---
title: "List Folder Contents"
method: GET
path: "/v1/folders/{id}/contents"
tags: ["Folders"]
---

# List Folder Contents

`GET /v1/folders/{id}/contents`

Retrieves basic information about the contents of a given folder. Results are paginated.

## Path parameters

- `id` union, required
  - number
  - 'root'

## Response `200`

OK with an array of Folder Content Resources containing information about the contents of the requested folder.

- FolderContent[]
  - `id` union, required — Unique ID of the folder or document being referred to. This field will be a Number for folders and a UUID for documents.
    - string, uuid
    - number
  - `type` 'folder' | 'document', required — * folder - Type denoting that the Folder Content Resource is a folder and will have a Number id field and no product field. * document - Type denoting that the Folder Content Resource is a document and will have a UUID id field and will contain a product field.
  - `name` string, required — Name of the folder or document
  - `isShortcut` boolean, required — A boolean value indicating whether or not the folder or document is a shortcut.
  - `product` 'lucidchart' | 'lucidscale' | 'lucidspark' — The Lucid Suite product that a document was created in.

## Other responses

- `403` — Forbidden if the app making the request does not have permission to the folder, or if the folder has been deleted or does not exist.

---

[API](https://skmtc.net/lucid/apis/lucid-rest-api.md) · [All operations](https://skmtc.net/lucid/apis/lucid-rest-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/lucid/lucid-rest-api/versions/6a32cb9e1aa7/schema)