GET /folders/`{folder_id}`

Returns detailed information about a specific folder — including the folder metadata and (when populated) aggregate fields like total videos, storage, and any attached resources (funnels, DRM groups).

📘
Authorization
Requires a valid Panda API token sent in the Authorization header (no Bearer prefix).

HTTP Method & Path

GET /folders/{folder_id}

Base URL: https://api-v2.pandavideo.com.br

Authentication Requirements

Security Scheme	Header	Note
API Key	`Authorization`	Panda API token (without Bearer prefix)

Parameters

Name	In	Type	Required	Description
`Authorization`	header	string	Yes	Panda API token (without Bearer prefix)

Path Parameters

Field	Type	Required	Description	Constraints
`folder_id`	string (uuid)	Yes	Unique identifier of the folder.	uuid

Response

Success Response (200)

{
  "id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
  "name": "My folder",
  "user_id": "ffffffff-1111-2222-3333-444444444444",
  "parent_folder_id": null,
  "status": true,
  "videos_count": "12",
  "storage_size": 1234567890,
  "length": 3600,
  "funnel": {
    "id": "11111111-2222-3333-4444-555555555555"
  },
  "drm_group_ids": [
    { "drm_group_id": "22222222-3333-4444-5555-666666666666", "active": true }
  ],
  "created_at": "2026-05-29T14:00:00.000Z",
  "updated_at": "2026-05-29T14:30:00.000Z"
}

Response Schema

Field	Type	Description
`id`	string (uuid)	Folder ID.
`name`	string	Folder name.
`user_id`	string (uuid)	Owner user ID.
`parent_folder_id`	string \| null	Parent folder ID, or `null` for root-level folders.
`status`	boolean	`true` = active, `false` = inactive (soft-deleted).
`videos_count`	string	Number of videos directly inside this folder (returned as string).
`storage_size`	integer	Total storage in bytes of all videos directly in this folder.
`length`	integer	Total duration in seconds of all videos in this folder.
`funnel`	object \| null	Funnel attached to this folder (if any) — `{ id }`.
`drm_group_ids`	array	DRM groups attached to this folder — each `{ drm_group_id, active }`.
`created_at`	string	ISO 8601 timestamp of creation.
`updated_at`	string	ISO 8601 timestamp of last update.

Error Responses

401 Unauthorized — Missing or invalid API token.
404 Not Found — Folder not found.
500 Internal Server Error — Server-side error.

Example Usage

cURL

curl -X GET \
  'https://api-v2.pandavideo.com.br/folders/<folder_id>' \
  -H 'Authorization: your_api_token_here' \
  -H 'Accept: application/json'

Recipes

200Folder details retrieved successfully

401Unauthorized - Invalid or missing authentication

404Not found - Resource does not exist

500Internal server error