get
https://api-v2.pandavideo.com.br/videos
Lists the videos in your account, paginated. Optional filters: status, title, folder_id (or root_folder=1 to only return videos in the account root).
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
GET /videos
Lists the videos in your account. Results are paginated and can be filtered by status, title, folder, or root-folder scope.
AuthorizationRequires a valid Panda API token sent in the
Authorizationheader (no Bearer prefix).
HTTP Method & Path
GET /videos
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 |
|---|---|---|---|---|
root_folder | integer | No | Set to 1 to return only videos that live in the root folder (no folder assigned). | int32 |
page | integer | No | Page number for pagination. Defaults to 1. | int32, min 1 |
limit | integer | No | Maximum number of videos returned per page. | int32 |
title | string | No | Filter videos by title (substring match). | — |
status | string | No | Filter videos by status. | enum: DRAFT, CONVERTING, CONVERTED, FAILED, BLOCKED, DELETING |
folder_id | string | No | Filter videos by folder ID. Mutually exclusive with root_folder. | uuid |
Response
Success Response (200)
{
"videos": [
{
"id": "11111111-2222-3333-4444-555555555555",
"title": "My video",
"description": "Sample description",
"status": "CONVERTED",
"user_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"folder_id": null,
"library_id": "ffffffff-1111-2222-3333-444444444444",
"video_external_id": "9988aabb-ccdd-eeff-1122-334455667788",
"converted_at": "2026-05-29T14:40:00.000Z",
"created_at": "2026-05-29T14:36:39.000Z",
"updated_at": "2026-05-29T20:15:41.000Z",
"storage_size": 12345678,
"length": 120,
"video_player": "https://player.pandavideo.com.br/embed/?v=9988aabb-ccdd-eeff-1122-334455667788",
"video_hls": "https://b-vz-xxx.b-cdn.net/.../playlist.m3u8",
"thumbnail": "https://b-vz-xxx.b-cdn.net/.../thumbnail.jpg"
}
]
}Response Schema
| Field | Type | Description |
|---|---|---|
videos | array | Page of video objects. |
videos[].id | string (uuid) | Internal ID of the video. |
videos[].title | string | Video title. |
videos[].description | string | Video description. |
videos[].status | string | Video status. Enum: DRAFT, CONVERTING, CONVERTED, FAILED, BLOCKED, DELETING. |
videos[].user_id | string (uuid) | Owner user ID. |
videos[].folder_id | string | null | Folder ID, or null when the video is in the root folder. |
videos[].library_id | string (uuid) | Library the video belongs to. |
videos[].video_external_id | string (uuid) | Public external ID (used in player URLs and webhooks). |
videos[].converted_at | string | null | ISO 8601 timestamp when conversion finished, null while still converting. |
videos[].created_at | string | ISO 8601 timestamp of creation. |
videos[].updated_at | string | ISO 8601 timestamp of last update. |
videos[].storage_size | integer | Size in bytes of the stored asset. |
videos[].length | integer | Video duration in seconds. |
videos[].video_player | string | Embeddable player URL. |
videos[].video_hls | string | HLS playback URL. |
videos[].thumbnail | string | Thumbnail image URL. |
Heads up:root_folder=1andfolder_idare mutually exclusive — sending both may result in unexpected filtering. Pick one.
Error Responses
- 400 Bad Request — Invalid query parameters.
- 401 Unauthorized — Missing or invalid API token.
- 404 Not Found — Resource not found.
- 500 Internal Server Error — Server-side error.
Example Usage
cURL
curl -X GET \
'https://api-v2.pandavideo.com.br/videos?page=1&limit=20' \
-H 'Authorization: your_api_token_here' \
-H 'Accept: application/json'cURL — filter by status and folder
curl -X GET \
'https://api-v2.pandavideo.com.br/videos?status=CONVERTED&folder_id=<folder-uuid>' \
-H 'Authorization: your_api_token_here' \
-H 'Accept: application/json'Recipes
The Recipes section provides a collection of code examples and sample implementations to help you understand and use the API effectively. Each recipe includes commented code that explains the purpose and functionality of each line.