---
title: "Gets a video stream."
method: HEAD
path: "/Videos/{itemId}/{stream}.{container}"
tags: ["Videos"]
---

# Gets a video stream.

`HEAD /Videos/{itemId}/{stream}.{container}`

## Path parameters

- `itemId` string, uuid, required — The item id.
- `container` string, required — The video container. Possible values are: ts, webm, asf, wmv, ogv, mp4, m4v, mkv, mpeg, mpg, avi, 3gp, wmv, wtv, m2ts, mov, iso, flv.
- `stream` string, required

## Query parameters

- `static` boolean, nullable — Optional. If true, the original file will be streamed statically without any encoding. Use either no url extension or the original file extension. true/false.
- `params` string, nullable — The streaming parameters.
- `tag` string, nullable — The tag.
- `deviceProfileId` string, nullable — Optional. The dlna device profile id to utilize.
- `playSessionId` string, nullable — The play session id.
- `segmentContainer` string, nullable — The segment container.
- `segmentLength` integer, nullable — The segment lenght.
- `minSegments` integer, nullable — The minimum number of segments.
- `mediaSourceId` string, nullable — The media version id, if playing an alternate version.
- `deviceId` string, nullable — The device id of the client requesting. Used to stop encoding processes when needed.
- `audioCodec` string, nullable — Optional. Specify a audio codec to encode to, e.g. mp3. If omitted the server will auto-select using the url's extension. Options: aac, mp3, vorbis, wma.
- `enableAutoStreamCopy` boolean, nullable — Whether or not to allow automatic stream copy if requested values match the original source. Defaults to true.
- `allowVideoStreamCopy` boolean, nullable — Whether or not to allow copying of the video stream url.
- `allowAudioStreamCopy` boolean, nullable — Whether or not to allow copying of the audio stream url.
- `breakOnNonKeyFrames` boolean, nullable — Optional. Whether to break on non key frames.
- `audioSampleRate` integer, nullable — Optional. Specify a specific audio sample rate, e.g. 44100.
- `maxAudioBitDepth` integer, nullable — Optional. The maximum audio bit depth.
- `audioBitRate` integer, nullable — Optional. Specify an audio bitrate to encode to, e.g. 128000. If omitted this will be left to encoder defaults.
- `audioChannels` integer, nullable — Optional. Specify a specific number of audio channels to encode to, e.g. 2.
- `maxAudioChannels` integer, nullable — Optional. Specify a maximum number of audio channels to encode to, e.g. 2.
- `profile` string, nullable — Optional. Specify a specific an encoder profile (varies by encoder), e.g. main, baseline, high.
- `level` string, nullable — Optional. Specify a level for the encoder profile (varies by encoder), e.g. 3, 3.1.
- `framerate` number, float, nullable — Optional. A specific video framerate to encode to, e.g. 23.976. Generally this should be omitted unless the device has specific requirements.
- `maxFramerate` number, float, nullable — Optional. A specific maximum video framerate to encode to, e.g. 23.976. Generally this should be omitted unless the device has specific requirements.
- `copyTimestamps` boolean, nullable — Whether or not to copy timestamps when transcoding with an offset. Defaults to false.
- `startTimeTicks` integer, nullable — Optional. Specify a starting offset, in ticks. 1 tick = 10000 ms.
- `width` integer, nullable — Optional. The fixed horizontal resolution of the encoded video.
- `height` integer, nullable — Optional. The fixed vertical resolution of the encoded video.
- `videoBitRate` integer, nullable — Optional. Specify a video bitrate to encode to, e.g. 500000. If omitted this will be left to encoder defaults.
- `subtitleStreamIndex` integer, nullable — Optional. The index of the subtitle stream to use. If omitted no subtitles will be used.
- `subtitleMethod` 'Encode' | 'Embed' | 'External' | 'Hls'
- `maxRefFrames` integer, nullable — Optional.
- `maxVideoBitDepth` integer, nullable — Optional. The maximum video bit depth.
- `requireAvc` boolean, nullable — Optional. Whether to require avc.
- `deInterlace` boolean, nullable — Optional. Whether to deinterlace the video.
- `requireNonAnamorphic` boolean, nullable — Optional. Whether to require a non anamporphic stream.
- `transcodingMaxAudioChannels` integer, nullable — Optional. The maximum number of audio channels to transcode.
- `cpuCoreLimit` integer, nullable — Optional. The limit of how many cpu cores to use.
- `liveStreamId` string, nullable — The live stream id.
- `enableMpegtsM2TsMode` boolean, nullable — Optional. Whether to enable the MpegtsM2Ts mode.
- `videoCodec` string, nullable — Optional. Specify a video codec to encode to, e.g. h264. If omitted the server will auto-select using the url's extension. Options: h265, h264, mpeg4, theora, vpx, wmv.
- `subtitleCodec` string, nullable — Optional. Specify a subtitle codec to encode to.
- `transcodeReasons` string, nullable — Optional. The transcoding reason.
- `audioStreamIndex` integer, nullable — Optional. The index of the audio stream to use. If omitted the first audio stream will be used.
- `videoStreamIndex` integer, nullable — Optional. The index of the video stream to use. If omitted the first video stream will be used.
- `context` 'Streaming' | 'Static'
- `streamOptions` object, nullable — Optional. The streaming options.

## Response `200`

Video stream returned.

---

[API](https://skmtc.net/jellyfin/apis/jellyfin-api.md) · [All operations](https://skmtc.net/jellyfin/apis/jellyfin-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jellyfin/jellyfin-api/versions/eb6f75af7066/schema)