---
title: "Get Folder"
method: GET
path: "/v2/folders/{id}"
tags: ["Folders"]
---

# Get Folder

`GET /v2/folders/{id}`

## Request

- Base URL: `https://api.lucid.co`
- URL: `https://api.lucid.co/v2/folders/{id}`
- Auth: one of:
  - HTTP bearer
  - OAuth 2
    - Authorization code: `https://lucid.app/oauth2/authorize`
    - Token URL: `https://api.lucid.co/oauth2/token` scopes: `folder:readonly`
- TypeScript: <https://skmtc.dev/lucid/apis/lucid-rest-api/docs/v2/folders/:id/get.ts> (a function with typed inputs; its response is checked against the schema)

Retrieves information about the requested folder.

## Path parameters

- `id` number, required

## Response `200`

OK with a Folder resource containing information about the requested folder.

- FolderWithRepositoryV2: A standard representation of a folder. A folder at the root of a Team reports that Team as its parent.
  - `id` number, required: Unique ID of the folder
  - `type` 'folder' | 'team', required: * folder - Folders can live in other folders, team folders, or the root of a user’s folder manager ("My Documents"). A folder in "My Documents" will have a null parent field. * team - Team folders can never live in another folder and are always located in the "Team Folders" section of a user's folder manager. Team folders will not have a parent field. Learn more
  - `name` string, required: Name of the folder
  - `parent` union: Where the folder lives: the numeric ID of the parent folder, or the `team_`-prefixed ID of the Team whose root contains it. Null for a folder at the root of the user's folder manager ("My Documents").
    - number, nullable
    - string
  - `created` string, date-time, required: Date and time of when the folder was created
  - `trashed` string, date-time, nullable: Date and time of when the folder was trashed. Null when the folder is not trashed.
  - `attributes` FolderAttribute[]: An array of attributes assigned to the folder. Can be null or empty.
    - `name` string: Name of the attribute
    - `value` string: Value of the attribute. Can be any type, but attributes with the same name will always have the same type.
  - `repository` Repository
    - `repositoryId` string: the ID of the repository

## Other responses

- `403`: Forbidden if the app making the request does not have permission to the folder, or if the folder has been deleted (trashed is okay) or does not exist.

## Changes

- **2026-11-03** `9c2c917ec59c`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/lucid/apis/lucid-rest-api/changes/v2/folders/:id/get.md)

---

[API](https://skmtc.dev/lucid/apis/lucid-rest-api.md) - [All operations](https://skmtc.dev/lucid/apis/lucid-rest-api/llms.txt) - [OpenAPI document](https://skmtc.dev/lucid/apis/lucid-rest-api/revisions/9c2c917ec59c?raw)