GET /videos

Lists the videos in your account. Results are paginated and can be filtered by status, title, folder, or root-folder scope.

📘
Authorization
Requires a valid Panda API token sent in the Authorization header (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=1 and folder_id are 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.

200200

400400

401401

404404

500500