GET /videos/{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.

📘

Authorization

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

HTTP Method & Path

GET /videos/{video_id}

Base URL: https://api-v2.pandavideo.com.br

Authentication Requirements

Parameters

Path Parameters

Query Parameters

📝 Storage size details

The storage_size_details object provides a breakdown of storage consumption per encoded quality. This is useful for identifying which resolutions consume the most storage and for planning quality removal via the partial deletion endpoint. Values are in bytes. The object includes:

• Each encoded quality (e.g. 240p, 360p, 480p, 720p, 1080p)
• backup: the original uploaded file (0 when backup is not enabled)
• images: thumbnails, preview frames, and seek sprites

Example request:

GET /videos/{video_id}?storage_size_details=true

Example response (excerpt):

JSON

{
  "storage_size": 57482073,
  "storage_size_details": {
    "240p": 5724536,
    "360p": 9325263,
    "480p": 14832453,
    "720p": 25167539,
    "backup": 0,
    "images": 3057966
  }
}

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",
  "pullzone_name": "vz-163a34ba-25b",
  "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" }
  ],
  "config": {
    "thumb": "9988aabb-.../video/2050634750-...-d_1920x1080",
    "ai": {
      "abstract": true,
      "mindmap": true,
      "questions": true,
      "pdf_generated": true,
      "resources": [
        { "type": "abstract", "srclang": "en", "pdf_url": "https://.../abstract.en.pdf" },
        { "type": "abstract", "srclang": "pt-BR", "is_legacy": true, "pdf_url": "https://.../abstract.pdf" },
        { "type": "questions", "srclang": "pt-BR", "is_legacy": true },
        { "type": "mindmap", "srclang": "pt-BR", "is_legacy": true }
      ]
    }
  }
}

Response Schema

AI resources — config.ai.resources[]

Each entry describes one resource in one language:

📘

Read the manifest, don't guess the path

To fetch AI content, read config.ai.resources[] first and request only the languages listed there. For each entry, the content lives at:

https://config.tv.pandavideo.com.br/{pullzone_name}/{video_external_id}-ai.{srclang}.json

Entries flagged is_legacy: true are read at {video_external_id}-ai.json, without the language suffix. Full field reference in Get Mind Map, eBook or Quiz.

⚠️

pdf_url is only here

The PDF URL is returned by this endpoint and is not written into the public config file. That is deliberate: inside the public file it would be a direct download link, bypassing the per-resource download permission (see AI Package Actions).

The file name follows the origin of the resource: v2 content uses abstract.{lang}.pdf, legacy content uses abstract.pdf, with no suffix.

📘

Tip

If you only have the external_id (public ID used in player URLs), append ?external_id to the path: GET /videos/{external_id}?external_id.

Error Responses

• 400 Bad Request — Invalid video_id format.
• 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.