get
https://api-v2.pandavideo.com.br/videos/
Returns the full properties of a video (status, playback URLs, technical metadata, folder, subtitles, audios) by internal video_id.
Recent Requests
Log in to see full request history
| Time | Status | User Agent | |
|---|---|---|---|
Retrieving recent requests… | |||
Loading…
GET /videos/{video_id}
{video_id}Returns the full properties of a specific video, identified by its internal video_id. Includes playback URLs, conversion status, technical metadata (resolution, length, storage), folder placement, and any attached audio/subtitle tracks.
AuthorizationRequires a valid Panda API token sent in the
Authorizationheader (no Bearer prefix).
HTTP Method & Path
GET /videos/{video_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 |
|---|---|---|---|---|
video_id | string (uuid) | Yes | Internal ID of the video to retrieve. | uuid |
Response
Success Response (200)
{
"id": "11111111-2222-3333-4444-555555555555",
"title": "My video",
"description": "Sample description",
"status": "CONVERTED",
"video_external_id": "9988aabb-ccdd-eeff-1122-334455667788",
"created_at": "2026-05-29T14:36:39.000Z",
"updated_at": "2026-05-29T20:15:41.000Z",
"converted_at": "2026-05-29T14:40:00.000Z",
"user_id": "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee",
"folder_id": null,
"library_id": "ffffffff-1111-2222-3333-444444444444",
"storage_size": 12345678,
"length": 120,
"width": 1920,
"height": 1080,
"compression_mode": "balanced",
"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",
"preview": "https://b-vz-xxx.b-cdn.net/.../preview.webp",
"playback": ["240p", "360p", "480p", "720p", "1080p"],
"playable": true,
"backup": true,
"video_offline_enabled": false,
"original_lang": "pt",
"subtitles": [
{ "srclang": "en", "translation": true }
],
"audios": [
{ "id": "audio-uuid", "language": "en", "type": "dubbing", "status": "READY" }
]
}Response Schema
| Field | Type | Description |
|---|---|---|
id | string (uuid) | Internal ID of the video. |
title | string | Video title. |
description | string | Video description. |
status | string | Conversion status. Enum: DRAFT, CONVERTING, CONVERTED, FAILED, BLOCKED, DELETING. |
video_external_id | string (uuid) | Public external ID (used in player URLs and webhooks). |
created_at | string | ISO 8601 timestamp of creation. |
updated_at | string | ISO 8601 timestamp of last update. |
converted_at | string | null | ISO 8601 timestamp when conversion finished, null while still converting. |
user_id | string (uuid) | Owner user ID. |
folder_id | string | null | Folder the video lives in, or null for root folder. |
library_id | string (uuid) | Library ID. |
storage_size | integer | Size in bytes of the stored asset. |
length | integer | Video duration in seconds. |
width / height | integer | Native video resolution in pixels. |
compression_mode | string | null | Compression profile the video was encoded with. Enum: size, balanced, quality (default balanced). null for videos encoded before this setting existed. |
video_player | string | Embeddable player URL. |
video_hls | string | HLS playback URL. |
thumbnail | string | Thumbnail image URL. |
preview | string | Hover-preview asset URL (animated webp). |
playback | array of string | Enabled playback qualities (e.g., "360p", "720p", "1080p"). |
playable | boolean | true when the video is ready to play. |
backup | boolean | true when a backup copy exists. |
video_offline_enabled | boolean | Whether secure offline viewing is enabled for the Panda app. |
original_lang | string | ISO language code of the original audio track. |
subtitles | array | Subtitle tracks. Each has srclang and flags transcription/translation. |
audios | array | Additional audio tracks (dubbings, alternate languages) with id, language, type, status. |
TipIf you only have the external_id (public ID used in player URLs), append
?external_idto the path:GET /videos/{external_id}?external_id.
Error Responses
- 400 Bad Request — Invalid
video_idformat. - 401 Unauthorized — Missing or invalid API token.
- 404 Not Found — Video not found.
- 500 Internal Server Error — Server-side error.
Example Usage
cURL
curl -X GET \
'https://api-v2.pandavideo.com.br/videos/<video_id>' \
-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.