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

# Get Folder

`GET /v3/folders/{folder_id}`

## Request

- Base URL: `https://api.heygen.com`
- URL: `https://api.heygen.com/v3/folders/{folder_id}`
- Auth: one of:
  - API key in header `x-api-key`
  - HTTP bearer

Returns one folder in your workspace, including one in the trash (`is_trash`). Use it to check that a stored `folder_id` still exists. Deleted folders and folders in other workspaces return 404.

## Path parameters

- `folder_id` string, required

## Response `200`

Successful response

- object
  - `data` FolderV3: A folder in the caller's workspace.
    - `folder_id` string, required: Unique folder identifier. Pass as folder_id to POST /v3/videos or POST /v3/video-translations. A folder of type 'mixed', 'video' or 'video_translate' may also be passed as parent_id to POST /v3/folders; 'asset' folders are flat.
    - `name` string, required: Folder name.
    - `parent_id` string, nullable: ID of the containing folder. Absent for a folder at the workspace root.
    - `type` 'mixed' | 'video' | 'video_translate' | 'asset', required: The kinds of folder this API knows: what GET returns and what a folder_id destination may name. These are the kinds the HeyGen app's New folder actions create. Brand kits and batch parents are not folders, so an id that resolves to one is reported as not found. Only 'mixed', 'video' and 'video_translate' folders may be a parent_id; 'asset' folders are flat.
    - `is_trash` boolean, required: Whether the folder is in the trash.
    - `created_at` integer, required: Unix timestamp (seconds) when the folder was created.
    - `updated_at` integer, required: Unix timestamp (seconds) when the folder was last updated.
    - `creator_username` string, nullable: Username of the workspace member who created the folder.

## Other responses

- `400`: Invalid request parameters
- `401`: Authentication failed
- `404`: Resource not found
- `429`: Rate limit exceeded

## Changes

- **2026-11-03** `7dfa5e59b4f5`: 1 info
  - endpoint added

[Operation history](https://skmtc.dev/heygen/apis/heygen-external-api/changes/v3/folders/:folder_id/get.md)

---

[API](https://skmtc.dev/heygen/apis/heygen-external-api.md) - [All operations](https://skmtc.dev/heygen/apis/heygen-external-api/llms.txt) - [OpenAPI document](https://skmtc.dev/heygen/apis/heygen-external-api/revisions/7dfa5e59b4f5?raw)