v1

latestOpenAPI 3.0.2Terms of Use2026-08-061441681.6 MB
videos

Fetch a video

This operation shows details for a single, specified video.

get/videos/{id}

Path parameters

idstring required
Example:51cd5c07-1583-4f5e-bd81-f1aa11510ea9

Unique identifier for the video.

Response

Success

Example response

{
  "video": {
    "id": "2aa3343e-2fb5-42c3-8671-b52c24b7c3e2",
    "name": "My video",
    "description": "A new video for my business.",
    "unpublished_at": "2025-01-01T12:33:22Z",
    "published_at": "2024-01-01T12:33:22Z",
    "tags": [
      "foo",
      "bar"
    ],
    "ad_keywords": "special_ads",
    "created_at": "2024-01-01T12:33:22Z",
    "updated_at": "2024-01-01T12:33:22Z",
    "state": "FINISHED",
    "images": [
      {
        "url": "https://example.com/image.jpg"
      }
    ],
    "encodings": [
      {
        "audio_bitrate_in_kbps": 2300,
        "audio_channel": 2,
        "audio_codec": "aac",
        "audio_sample_rate": 44100,
        "height": 1080,
        "width": 1920,
        "video_file_url": "https://flowplayer.com/video.mp4",
        "video_container": "mp4",
        "video_codec": "h264",
        "total_bitrate_in_kbps": 1023,
        "size_in_bytes": 8325555
      }
    ],
    "ad_insertion_points": [
      {
        "offset_from_start_in_ms": 20000,
        "description": "mid-roll"
      }
    ],
    "animated_previews": [
      {
        "height": 1080,
        "width": 1920
      }
    ],
    "playback_token_behavior": "NO_TOKEN",
    "origin": {
      "id": "wqrs0k75",
      "type": "live_stream",
      "uptime_id": "hvpcp3kn"
    }
  }
}