---
id: get-transcode-sessions
sidebar_label: Get Transcode Sessions
hide_title: true
hide_table_of_contents: true
api: {"tags":["Sessions"],"description":"Get Transcode Sessions","operationId":"getTranscodeSessions","responses":{"200":{"description":"The Transcode Sessions","content":{"application/json":{"schema":{"type":"object","properties":{"MediaContainer":{"type":"object","properties":{"size":{"type":"number","example":1},"TranscodeSession":{"type":"array","items":{"type":"object","properties":{"key":{"type":"string","example":"zz7llzqlx8w9vnrsbnwhbmep"},"throttled":{"type":"boolean"},"complete":{"type":"boolean"},"progress":{"type":"number","example":0.4000000059604645},"size":{"type":"number","example":-22},"speed":{"type":"number","example":22.399999618530273},"error":{"type":"boolean"},"duration":{"type":"number","example":2561768},"context":{"type":"string","example":"streaming"},"sourceVideoCodec":{"type":"string","example":"h264"},"sourceAudioCodec":{"type":"string","example":"ac3"},"videoDecision":{"type":"string","example":"transcode"},"audioDecision":{"type":"string","example":"transcode"},"protocol":{"type":"string","example":"http"},"container":{"type":"string","example":"mkv"},"videoCodec":{"type":"string","example":"h264"},"audioCodec":{"type":"string","example":"opus"},"audioChannels":{"type":"number","example":2},"transcodeHwRequested":{"type":"boolean"},"timeStamp":{"type":"number","example":1681869535.7764285},"maxOffsetAvailable":{"type":"number","example":861.778},"minOffsetAvailable":{"type":"number","example":0}}}}}}}}}}},"401":{"description":"Unauthorized - Returned if the X-Plex-Token is missing from the header or query.","content":{"application/json":{"schema":{"type":"object","properties":{"errors":{"type":"array","items":{"type":"object","properties":{"code":{"type":"number","example":1001},"message":{"type":"string","example":"User could not be authenticated"},"status":{"type":"number","example":401}}}}}}}}}},"method":"get","path":"/transcode/sessions","servers":[{"url":"http://{Local IP}:{Port}","variables":{"Local IP":{"default":"10.10.10.47","description":"The Local IP Address of your plex server"},"Port":{"default":"32400","description":"The port to access your plex server"}}},{"url":"https://{Local IP}:{Port}","variables":{"Local IP":{"default":"10.10.10.47","description":"The Local IP Address of your plex server"},"Port":{"default":"32400","description":"The port to access your plex server"}}}],"security":[{"Token":[],"ClientIdentifier":[],"Device":[],"DeviceName":[],"Platform":[],"PlatformVersion":[],"Product":[],"Version":[]}],"securitySchemes":{"Token":{"description":"Plex Authentication Token","type":"apiKey","in":"header","name":"X-Plex-Token"},"ClientIdentifier":{"description":"Plex Authentication Token","type":"apiKey","in":"header","name":"X-Plex-Client-Identifier"},"DeviceName":{"description":"Primary name for the device eg. `Plex Web (Chrome)`","type":"apiKey","in":"header","name":"X-Plex-Device-Name"},"Device":{"description":"The type of device your application is running on\nDevice name and or model number, eg `iPhone3,2`, `Motorola XOOM™`, `LG5200TV`\n","type":"apiKey","in":"header","name":"X-Plex-Device"},"PlatformVersion":{"description":"Operating system version\neg `4.3.1`, `10.6.7`, `3.2`\n","type":"apiKey","in":"header","name":"X-Plex-Platform-Version"},"Platform":{"description":"Platform name \neg: `Web`, `iOS`, `MacOSX`, `Android`, `LG`\n","type":"apiKey","in":"header","name":"X-Plex-Platform"},"Product":{"description":"Plex application name \neg: `Laika`, `Plex Media Server`, `Media Link`\n","type":"apiKey","in":"header","name":"X-Plex-Product"},"Version":{"description":"Plex application version number","type":"apiKey","in":"header","name":"X-Plex-Version"}},"info":{"title":"Plex-API","summary":"A Plex Media Server API Map","description":"An Open API Spec for interacting with Plex.tv and Plex Servers","version":"0.0.3","contact":{"name":"Luke Hagar","url":"https://www.LukeHagar.com","email":"Lukeslakemail@gmail.com"},"license":{"name":"MIT","identifier":"MIT","url":"https://opensource.org/licenses/MIT"}},"postman":{"name":"Get Transcode Sessions","description":{"content":"Get Transcode Sessions","type":"text/plain"},"url":{"path":["transcode","sessions"],"host":["{{baseUrl}}"],"query":[],"variable":[]},"header":[{"key":"Accept","value":"application/json"}],"method":"GET"}}
sidebar_class_name: "get api-method"
info_path: docs/plex-media-server/plex-api
---

import ApiTabs from "@theme/ApiTabs";
import DiscriminatorTabs from "@theme/DiscriminatorTabs";
import MethodEndpoint from "@theme/ApiDemoPanel/MethodEndpoint";
import MimeTabs from "@theme/MimeTabs";
import ParamsItem from "@theme/ParamsItem";
import ResponseSamples from "@theme/ResponseSamples";
import SchemaItem from "@theme/SchemaItem";
import SchemaTabs from "@theme/SchemaTabs";
import TabItem from "@theme/TabItem";

<h1 className={"openapi__heading"}>Get Transcode Sessions</h1>

<MethodEndpoint method={"get"} path={"/transcode/sessions"}></MethodEndpoint>



Get Transcode Sessions

<div><div><ApiTabs><TabItem label={"200"} value={"200"}><div>

The Transcode Sessions

</div><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details"} data-collapsed={false} open={true}><summary style={{"textAlign":"left"}}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><strong>MediaContainer</strong><span style={{"opacity":"0.6"}}> object</span></summary><div style={{"marginLeft":"1rem"}}><SchemaItem collapsible={false} name={"size"} required={false} schemaName={"number"} qualifierMessage={undefined} schema={{"type":"number","example":1}}></SchemaItem><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><strong>TranscodeSession</strong><span style={{"opacity":"0.6"}}> object[]</span></summary><div style={{"marginLeft":"1rem"}}><li><div style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem","paddingBottom":".5rem"}}>Array [</div></li><SchemaItem collapsible={false} name={"key"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"zz7llzqlx8w9vnrsbnwhbmep"}}></SchemaItem><SchemaItem collapsible={false} name={"throttled"} required={false} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean"}}></SchemaItem><SchemaItem collapsible={false} name={"complete"} required={false} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean"}}></SchemaItem><SchemaItem collapsible={false} name={"progress"} required={false} schemaName={"number"} qualifierMessage={undefined} schema={{"type":"number","example":0.4000000059604645}}></SchemaItem><SchemaItem collapsible={false} name={"size"} required={false} schemaName={"number"} qualifierMessage={undefined} schema={{"type":"number","example":-22}}></SchemaItem><SchemaItem collapsible={false} name={"speed"} required={false} schemaName={"number"} qualifierMessage={undefined} schema={{"type":"number","example":22.399999618530273}}></SchemaItem><SchemaItem collapsible={false} name={"error"} required={false} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean"}}></SchemaItem><SchemaItem collapsible={false} name={"duration"} required={false} schemaName={"number"} qualifierMessage={undefined} schema={{"type":"number","example":2561768}}></SchemaItem><SchemaItem collapsible={false} name={"context"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"streaming"}}></SchemaItem><SchemaItem collapsible={false} name={"sourceVideoCodec"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"h264"}}></SchemaItem><SchemaItem collapsible={false} name={"sourceAudioCodec"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"ac3"}}></SchemaItem><SchemaItem collapsible={false} name={"videoDecision"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"transcode"}}></SchemaItem><SchemaItem collapsible={false} name={"audioDecision"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"transcode"}}></SchemaItem><SchemaItem collapsible={false} name={"protocol"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"http"}}></SchemaItem><SchemaItem collapsible={false} name={"container"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"mkv"}}></SchemaItem><SchemaItem collapsible={false} name={"videoCodec"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"h264"}}></SchemaItem><SchemaItem collapsible={false} name={"audioCodec"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"opus"}}></SchemaItem><SchemaItem collapsible={false} name={"audioChannels"} required={false} schemaName={"number"} qualifierMessage={undefined} schema={{"type":"number","example":2}}></SchemaItem><SchemaItem collapsible={false} name={"transcodeHwRequested"} required={false} schemaName={"boolean"} qualifierMessage={undefined} schema={{"type":"boolean"}}></SchemaItem><SchemaItem collapsible={false} name={"timeStamp"} required={false} schemaName={"number"} qualifierMessage={undefined} schema={{"type":"number","example":1681869535.7764285}}></SchemaItem><SchemaItem collapsible={false} name={"maxOffsetAvailable"} required={false} schemaName={"number"} qualifierMessage={undefined} schema={{"type":"number","example":861.778}}></SchemaItem><SchemaItem collapsible={false} name={"minOffsetAvailable"} required={false} schemaName={"number"} qualifierMessage={undefined} schema={{"type":"number","example":0}}></SchemaItem><li><div style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem"}}>]</div></li></div></details></SchemaItem></div></details></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"MediaContainer\": {\n    \"size\": 1,\n    \"TranscodeSession\": [\n      {\n        \"key\": \"zz7llzqlx8w9vnrsbnwhbmep\",\n        \"throttled\": true,\n        \"complete\": true,\n        \"progress\": 0.4000000059604645,\n        \"size\": -22,\n        \"speed\": 22.399999618530273,\n        \"error\": true,\n        \"duration\": 2561768,\n        \"context\": \"streaming\",\n        \"sourceVideoCodec\": \"h264\",\n        \"sourceAudioCodec\": \"ac3\",\n        \"videoDecision\": \"transcode\",\n        \"audioDecision\": \"transcode\",\n        \"protocol\": \"http\",\n        \"container\": \"mkv\",\n        \"videoCodec\": \"h264\",\n        \"audioCodec\": \"opus\",\n        \"audioChannels\": 2,\n        \"transcodeHwRequested\": true,\n        \"timeStamp\": 1681869535.7764285,\n        \"maxOffsetAvailable\": 861.778,\n        \"minOffsetAvailable\": 0\n      }\n    ]\n  }\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem><TabItem label={"401"} value={"401"}><div>

Unauthorized - Returned if the X-Plex-Token is missing from the header or query.

</div><div><MimeTabs className={"openapi-tabs__mime"} schemaType={"response"}><TabItem label={"application/json"} value={"application/json"}><SchemaTabs className={"openapi-tabs__schema"}><TabItem label={"Schema"} value={"Schema"}><details style={{}} className={"openapi-markdown__details"} data-collapsed={false} open={true}><summary style={{"textAlign":"left"}}><strong>Schema</strong></summary><div style={{"textAlign":"left","marginLeft":"1rem"}}></div><ul style={{"marginLeft":"1rem"}}><SchemaItem collapsible={true} className={"schemaItem"}><details style={{}} className={"openapi-markdown__details"}><summary style={{}}><strong>errors</strong><span style={{"opacity":"0.6"}}> object[]</span></summary><div style={{"marginLeft":"1rem"}}><li><div style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem","paddingBottom":".5rem"}}>Array [</div></li><SchemaItem collapsible={false} name={"code"} required={false} schemaName={"number"} qualifierMessage={undefined} schema={{"type":"number","example":1001}}></SchemaItem><SchemaItem collapsible={false} name={"message"} required={false} schemaName={"string"} qualifierMessage={undefined} schema={{"type":"string","example":"User could not be authenticated"}}></SchemaItem><SchemaItem collapsible={false} name={"status"} required={false} schemaName={"number"} qualifierMessage={undefined} schema={{"type":"number","example":401}}></SchemaItem><li><div style={{"fontSize":"var(--ifm-code-font-size)","opacity":"0.6","marginLeft":"-.5rem"}}>]</div></li></div></details></SchemaItem></ul></details></TabItem><TabItem label={"Example (from schema)"} value={"Example (from schema)"}><ResponseSamples responseExample={"{\n  \"errors\": [\n    {\n      \"code\": 1001,\n      \"message\": \"User could not be authenticated\",\n      \"status\": 401\n    }\n  ]\n}"} language={"json"}></ResponseSamples></TabItem></SchemaTabs></TabItem></MimeTabs></div></TabItem></ApiTabs></div></div>