---
title: "Retrieve HLS Content"
method: GET
path: "/hls/{room_id}/{filename}"
tags: ["hls"]
---

# Retrieve HLS Content

`GET /hls/{room_id}/{filename}`

## Path parameters

- `room_id` string, required
- `filename` string, required

## Query parameters

- `_HLS_msn` integer, nullable — Segment sequence number
- `_HLS_part` integer, nullable — Partial segment sequence number
- `_HLS_skip` string, nullable — Set to "YES" if delta manifest should be requested

## Headers

- `range` string

## Response `200`

File was found

- string — Requested file

## Other responses

- `301` — Resource available on another Fishjam instance
- `400` — Invalid filename
- `404` — File not found
- `503` — Service temporarily unavailable

## Changes

- **2026-07-17** `7227c4e436c0` — 2 info
  - added the non-success response with the status `301`
  - added the non-success response with the status `503`
- **2023-12-14** `ac17ad2abfa4` — 1 breaking
  - removed the enum value `YES` from the `query` request parameter `_HLS_skip`
- **2023-12-08** `9453a0d77f74` — 1 info
  - added the non-success response with the status `400`
- **2023-10-31** `cc6d4b734a4c` — 1 info
  - api operation id `JellyfishWeb.HLSController.index` removed and replaced with `getHlsContent`
- **2023-10-27** `ef2224df51a4` — 1 info
  - api tag `hls` added

[Full history](https://skmtc.dev/fishjam-dev/apis/fishjam-media-server/changes/hls/:room_id/:filename/get.md)

---

[API](https://skmtc.dev/fishjam-dev/apis/fishjam-media-server.md) · [All operations](https://skmtc.dev/fishjam-dev/apis/fishjam-media-server/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/fishjam-dev/fishjam-media-server/revisions/7227c4e436c0/schema)