---
title: "Retrieve sessions"
method: GET
path: "/session"
tags: ["session"]
---

# Retrieve sessions

`GET /session`

## 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
  - `record` boolean — Whether the stream should be recorded. Uses default settings. For more customization, create and configure an object store.
  - `recordingStatus` 'waiting' | 'ready' | 'failed' | '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` FfmpegProfile[]
    - `width` integer, required
    - `name` string, required
    - `height` integer, required
    - `bitrate` integer, required
    - `fps` integer, required
    - `fpsDen` integer
    - `quality` integer — Restricts the size of the output video using the constant quality feature. Increasing this value will result in a lower quality video. Note that this parameter might not work if the transcoder lacks support for it.
    - `gop` string
    - `profile` 'H264Baseline' | 'H264Main' | 'H264High' | 'H264ConstrainedHigh'
    - `encoder` 'H.264'

## Other responses

- `default` — Error

## Changes

- **2024-05-17** `fc477586b24c` — 3 breaking, 2 info
  - the response property `errors` became optional for the status `default`
  - response property `items/isHealthy` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - response property `items/issues` list-of-types was widened by adding types `null` to media type `application/json` of response `200`
  - added the optional property `items/kind` to the response with the `200` status
  - …1 more
- **2024-05-14** `41d846566009` — 1 warning
  - removed the optional property `items/projectId` from the response with the `200` status
- **2024-05-10** `9a1157a504ba` — 1 info
  - added the optional property `items/projectId` to the response with the `200` status
- **2024-05-06** `e3e1153f9729` — 1 warning
  - added the new `failed` enum value to the `items/recordingStatus` response property for the response status `200`
- **2024-04-23** `d0909f9b9414` — 2 info
  - api operation id `getSessions` was added
  - api tag `session` added

[Full history](https://skmtc.dev/livepeer/apis/livepeer-api-reference/changes/session/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/fc477586b24c/schema)