---
title: "Gets an HLS subtitle playlist."
method: GET
path: "/Videos/{itemId}/{mediaSourceId}/Subtitles/{index}/subtitles.m3u8"
tags: ["Subtitle"]
---

# Gets an HLS subtitle playlist.

`GET /Videos/{itemId}/{mediaSourceId}/Subtitles/{index}/subtitles.m3u8`

## Request

- Base URL: `http://localhost`
- URL: `http://localhost/Videos/{itemId}/{mediaSourceId}/Subtitles/{index}/subtitles.m3u8`
- Auth: API key in header `X-Emby-Authorization`
- TypeScript: <https://skmtc.dev/jellyfin/apis/jellyfin-api/docs/Videos/:itemId/:mediaSourceId/Subtitles/:index/subtitles.m3u8/get.ts> (a function with typed inputs; its response is checked against the schema)

## Path parameters

- `itemId` string, uuid, required: The item id.
- `index` integer, required: The subtitle stream index.
- `mediaSourceId` string, required: The media source id.

## Query parameters

- `segmentLength` integer, required: The subtitle segment length.

## Response `200`

Subtitle playlist retrieved.

## Other responses

- `401`: Unauthorized
- `403`: Forbidden

---

[API](https://skmtc.dev/jellyfin/apis/jellyfin-api.md) - [All operations](https://skmtc.dev/jellyfin/apis/jellyfin-api/llms.txt) - [OpenAPI document](https://skmtc.dev/jellyfin/apis/jellyfin-api/revisions/eb6f75af7066?raw)