---
title: "Get stream for VOD"
method: GET
path: "/streams/w/vod/streamID"
tags: ["Streams"]
---

# Get stream for VOD

`GET /streams/w/vod/streamID`

Returns a stream for a given streamID if stream's course is public OR stream's course has visibility "loggedIn" and user is logged in / valid jwt is present OR stream's course has visibility "enrolled" and user is enrolled in stream's course.

## Query parameters

- `streamID` string, uint64

## Response `200`

A successful response.

- ProtobufGetStreamResponse
  - `stream` ProtobufStream
    - `id` string, uint64
    - `name` string
    - `description` string
    - `courseID` integer
    - `start` string, date-time
    - `end` string, date-time
    - `chatEnabled` boolean
    - `roomName` string
    - `roomCode` string
    - `eventTypeName` string
    - `TUMOnlineEventID` integer
    - `seriesIdentifier` string
    - `playlistUrl` string
    - `playlistUrlPRES` string
    - `playlistUrlCAM` string
    - `liveNow` boolean
    - `liveNowTimestamp` string, date-time
    - `recording` boolean
    - `premiere` boolean
    - `ended` boolean
    - `vodViews` integer
    - `startOffset` integer
    - `endOffset` integer
    - `duration` integer
    - `downloads` ProtobufDownload[]
      - `friendlyName` string
      - `downloadURL` string
    - `isPlanned` boolean
    - `isComingUp` boolean
    - `HLSUrl` string

## Other responses

- `400` — **[3 INVALID_ARGUMENT]** *Bad request.* **Returned in case of:** - Missing courseID field in request message.
- `401` — **[16 UNAUTHENTICATED]** *Could not authorize the operation.* **Returned in case of:** - Crypto/rsa: verification error (invalid jwt) - JWT cookie not found
- `403` — **[7 PERMISSION_DENIED]** *Access denied.* **Returned in case of:** - User is not logged in (jwt not set) and tries to access stream with course visibility "loggedIn" or "enrolled" - User is logged in, but tries to access stream with course visibility "enrolled" without being enrolled in the course - User tries to access stream with course visibility "private"
- `404` — **[5 NOT_FOUND]** *Could not find entity.* **Returned in case of:** - Non-existing stream or course

---

[API](https://skmtc.dev/tum-dev/apis/gocast-api.md) · [All operations](https://skmtc.dev/tum-dev/apis/gocast-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/tum-dev/gocast-api/revisions/18ce08adf685/schema)