GET /folders

Lists folders in the authenticated account. Optional filters let you scope to direct children of a specific folder or include/exclude inactive folders.

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

HTTP Method & Path

GET /folders

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)

Query Parameters

Field	Type	Required	Description	Constraints
`parent_folder_id`	string (uuid)	No	Filter by parent folder — returns only its direct children.	uuid
`status`	boolean	No	Filter by status. Default `true` (only active folders).	—

Response

Success Response (200)

The backend may return either a plain array or an object with a folders key — accept both:

[
  {
    "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",
    "created_at": "2026-05-29T14:00:00.000Z",
    "updated_at": "2026-05-29T14:30:00.000Z"
  }
]

Response Schema (item)

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. `null` when the folder lives in the account root.
`status`	boolean	`true` = active, `false` = inactive (soft-deleted).
`videos_count`	string	Number of videos directly inside this folder (returned as string).
`created_at`	string	ISO 8601 timestamp of creation.
`updated_at`	string	ISO 8601 timestamp of last update.

📘
Response shape
Accept either format defensively: Array.isArray(res) ? res : (res.folders ?? []).

Error Responses

401 Unauthorized — Missing or invalid API token.
500 Internal Server Error — Server-side error.

Example Usage

cURL — list root-level folders

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

cURL — list children of a specific folder

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

Recipes

200List of user folders retrieved successfully

400Bad request - Invalid input parameters

401Unauthorized - Invalid or missing authentication

500Internal server error