---
title: "Retrieve Recorded Sessions"
method: GET
path: "/stream/{parentId}/sessions"
tags: ["session"]
---

# Retrieve Recorded Sessions

`GET /stream/{parentId}/sessions`

## Path parameters

- `parentId` string, required

## Query parameters

- `record` union
  - boolean
  - integer

## Response `200`

Success

- Session[]
  - `id` string
  - `kind` string
  - `userId` string
  - `name` string, required
  - `lastSeen` number
  - `sourceSegments` number
  - `transcodedSegments` number
  - `sourceSegmentsDuration` number — Duration of all the source segments, sec
  - `transcodedSegmentsDuration` number — Duration of all the transcoded segments, sec
  - `sourceBytes` number
  - `transcodedBytes` number
  - `ingestRate` number — Rate at which sourceBytes increases (bytes/second)
  - `outgoingRate` number — Rate at which transcodedBytes increases (bytes/second)
  - `isHealthy` IsHealthy — unresolved $ref
  - `issues` HumanIssues — unresolved $ref
  - `createdAt` number — Timestamp (in milliseconds) at which stream object was created
  - `parentId` string — Points to parent stream object
  - `projectId` string — The ID of the project
  - `record` boolean — Whether the stream should be recorded. Uses default settings. For more customization, create and configure an object store.
  - `recordingStatus` 'waiting' | 'ready' | 'failed' | 'deleted' | 'none' — The status of the recording process of this stream session.
  - `recordingUrl` string — URL for accessing the recording of this stream session.
  - `mp4Url` string — The URL for the stream session recording packaged in an MP4.
  - `playbackId` string — The playback ID to use with the Playback Info endpoint to retrieve playback URLs.
  - `profiles` Profiles — unresolved $ref
  - `recordingSpec` RecordingSpec — unresolved $ref

## Other responses

- `default` — Error

## Changes

- **2024-09-11** `b9ec2e3c4b79` — 1 warning
  - added the new `deleted` enum value to the `items/recordingStatus` response property for the response status `200`
- **2024-06-18** `82356f03be94` — 4 breaking, 3 warning, 1 info
  - the response property `items/recordingSpec/profiles/items/fps` became optional for the status `200`
  - the response property `items/recordingSpec/profiles/items/height` became optional for the status `200`
  - the response property `items/recordingSpec/profiles/items/name` became optional for the status `200`
  - the response property `items/recordingSpec/profiles/items/width` became optional for the status `200`
  - …4 more
- **2024-06-11** `7c015b7e287c` — 1 info
  - added the optional property `items/projectId` to the response with the `200` status
- **2024-06-11** `8ccb056ca148` — 1 warning
  - removed the optional property `items/projectId` from the response with the `200` status
- **2024-06-11** `7c015b7e287c` — 1 info
  - added the optional property `items/projectId` to the response with the `200` status

[Full history](https://skmtc.dev/livepeer/apis/livepeer-api-reference/changes/stream/:parentId/sessions/get.md)

---

[API](https://skmtc.dev/livepeer/apis/livepeer-api-reference.md) · [All operations](https://skmtc.dev/livepeer/apis/livepeer-api-reference/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/livepeer/livepeer-api-reference/revisions/0d7e15217608/schema)