get
https://api-v2.pandavideo.com.br/folders
Lists folders in the account. Optional filters by parent_folder_id (direct children only) and status (active vs inactive).
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
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.
AuthorizationRequires a valid Panda API token sent in the
Authorizationheader (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 shapeAccept 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'